GlassFrog

GlassFrog is a cloud-based organizational management platform purpose-built for Holacracy practitioners. Developed by the founders of Holacracy, GlassFrog helps businesses implement, support, and manage self-organizing governance models by providing real-time visibility into roles, circles, accountabilities, projects, and actions. The platform enables organizations to maintain transparent governance records, run tactical and governance meetings, and track who is responsible for what—eliminating ambiguity and empowering distributed decision-making. GlassFrog's API (v3) provides programmatic access to your organization's governance data, including circles, roles, accountabilities, people, projects, and actions, enabling integration with external analytics, reporting, and data management tools.

Power end-to-end data operations for your GlassFrog API with Nexla. Our bi-directional GlassFrog connector is purpose-built for GlassFrog, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to GlassFrog or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your GlassFrog workflows fast, secure, and fully governed.

Features

Type: API

SourceDestination

• Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
• Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
• API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
• Request optimization with intelligent batching, retry, and caching to minimize API calls and costs

Prerequisites

To connect Nexla to GlassFrog, you need a GlassFrog account and an API key. GlassFrog API keys are associated with individual user accounts and carry the same permissions as that user. The GlassFrog API (v3) uses JSON and requires an API key for all requests.

Obtain a GlassFrog API Key

GlassFrog allows you to create multiple API keys—one per integration—so that individual keys can be revoked without disrupting other connections.

1. Sign in to your GlassFrog account at app.glassfrog.com.

2. Click your name or avatar in the top-right corner of the application to open the account dropdown menu.

3. Select Profile & Settings from the dropdown.

4. Navigate to the API tab within your profile settings.

5. Enter a descriptive label for the new API key in the label field (for example, Nexla Integration) to help identify its purpose later.

6. Click the button to generate the new API key.

7. Copy the API key immediately and store it in a secure location. The full key value is displayed only at the time of creation.

Important

GlassFrog API keys provide access to your organization's governance data with the same permissions as your user account. Treat API keys like passwords—do not share them in publicly accessible locations or commit them to version control. If a key is compromised, navigate back to Profile & Settings > API and delete the affected key, then create a replacement.

For additional information about GlassFrog API keys, refer to the official GlassFrog support documentation at support.glassfrog.com/glassfrog-api-keys.

Authenticate

Create a credential in Nexla

1. After selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

2. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

3. GlassFrog API v3 authenticates requests using an API key, which can be supplied either as a URL query parameter (?api_key=YOUR_KEY) or as the value of the X-Auth-Token request header. Nexla uses the header-based method, which keeps the key out of logged URLs. Enter the GlassFrog API key you generated in Prerequisites in the API Key field. This key authenticates Nexla with the GlassFrog API and must remain confidential.

4. Click the Save button at the bottom of the overlay. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation and can be selected for use with a new data source or destination.

Use as a data source

The GlassFrog API connector enables you to ingest your organization's governance data—including circles, roles, people, accountabilities, projects, actions, and metrics—from GlassFrog into Nexla for reporting, analytics, and integration with other systems. This connector is particularly useful for organizations that want to analyze role distribution, track governance health, or synchronize holacratic structure data with external platforms.

To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the GlassFrog API connector tile, then select the credential that will be used to connect to the GlassFrog API, and click Next; or, create a new GlassFrog API credential for use in this flow.

Endpoint templates

Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common GlassFrog API endpoints. Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below.

List Role Assignments

Retrieves all role assignments — person-to-role mappings — in the GlassFrog organization, with optional filtering by circle, role, or person.

• Sends a GET request to https://api.glassfrog.com/api/v3/assignments with optional filter parameters and returns an array of assignment objects.
• Response data is located at $.assignments[*].
• Configure the following parameters: Circle Id — filter by circle ID; Role Id — filter by role ID; Person Id — filter by person ID. All parameters are optional.

All filter parameters are optional. Omit them to retrieve all role assignments across the organization.

Get Circle

Returns the details of a single GlassFrog circle by its ID, including its name, purpose, and parent circle relationship.

• Sends a GET request to https://api.glassfrog.com/api/v3/circles/{id} and returns the circle object.
• Response data is located at $.circles[*].
• Configure the following parameter: Circle ID — the unique identifier of the circle to retrieve.

Use the List Circles endpoint to discover valid circle IDs in your organization.

Get Role

Returns the details of a single GlassFrog role by its ID, including purpose, domains, and accountabilities.

• Sends a GET request to https://api.glassfrog.com/api/v3/roles/{id} and returns the role object.
• Response data is located at $.roles[*].
• Configure the following parameter: Role ID — the unique identifier of the role to retrieve.

Role IDs can be found via the List Role Assignments endpoint or through the GlassFrog web interface.

Get Person

Returns the details of a single GlassFrog organization member by their ID, including name, email, and external ID.

• Sends a GET request to https://api.glassfrog.com/api/v3/people/{id} and returns the person object.
• Response data is located at $.people[*].
• Configure the following parameter: Person ID — the unique identifier of the person to retrieve.

Person IDs can be found via the List Role Assignments endpoint or other GlassFrog endpoints that return linked people data.

Get Project

Returns the details of a single GlassFrog project by its ID, including its status, description, and owning role.

• Sends a GET request to https://api.glassfrog.com/api/v3/projects/{id} and returns the project object.
• Response data is located at $.projects[*].
• Configure the following parameter: Project ID — the unique identifier of the project to retrieve.

Project IDs can be discovered by retrieving the full list of projects via a custom GET request to https://api.glassfrog.com/api/v3/projects.

Get Metric

Retrieves a single GlassFrog metric by its ID, including its description, frequency, and associated role.

• Sends a GET request to https://api.glassfrog.com/api/v3/metrics/{id} and returns the metric object.
• Response data is located at $.metrics[*].
• Configure the following parameter: Id — the unique identifier of the metric to retrieve.

Metric IDs can be found via a list request to https://api.glassfrog.com/api/v3/metrics.

Get Checklist Item

Retrieves a single GlassFrog checklist item by its ID, including its description and associated role.

• Sends a GET request to https://api.glassfrog.com/api/v3/checklist_items/{id} and returns the checklist item object.
• Response data is located at $.checklist_items[*].
• Configure the following parameter: Id — the unique identifier of the checklist item to retrieve.

Checklist item IDs can be found via a list request to https://api.glassfrog.com/api/v3/checklist_items.

Get Assignment

Retrieves a single role assignment by its ID, returning the person-to-role mapping for that specific assignment.

• Sends a GET request to https://api.glassfrog.com/api/v3/assignments/{id} and returns the assignment object.
• Response data is located at $.assignments[*].
• Configure the following parameter: Id — the unique identifier of the assignment to retrieve.

Assignment IDs can be found via the List Role Assignments endpoint.

List Circles

Lists all circles in the GlassFrog organization, providing a complete view of the organization's governance structure.

• Sends a GET request to https://api.glassfrog.com/api/v3/circles and returns an array of circle objects.
• Response data is located at $.circles[*].

No parameters are required. Use the returned circle IDs with the Get Circle or List Role Assignments endpoints for further data retrieval.

List Actions

Lists all next-actions and tensions captured in GlassFrog tactical meetings, useful for tracking organizational action items.

• Sends a GET request to https://api.glassfrog.com/api/v3/actions and returns an array of action objects.
• Response data is located at $.actions[*].

No parameters are required. Each action includes its description, status, and owning person and role.

Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to retrieve a sample of the data that will be fetched. Sample data will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the source is configured correctly before saving.

Manual configuration

GlassFrog API sources can also be manually configured to ingest data from any valid GlassFrog API v3 endpoint. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, endpoint URL, date/time and lookup macros, path to data, metadata, and request headers.

All GlassFrog API v3 endpoints use the base URL https://api.glassfrog.com/api/v3/ and return JSON responses. The API is read-focused, so GET is the most common method; common endpoint paths include /circles, /roles, /people, /projects, /actions, /checklist_items, /metrics, and /triggers.

GlassFrog API v3 responses wrap records in a JSON object whose top-level key matches the resource name—for example, a request to /circles returns a circles array. Enter the corresponding path (e.g., $.circles[*], $.roles[*]) in the Set Path to Data in Response field so Nexla treats each element as a separate record. Responses often also include a linked object containing referenced data, such as people linked to roles; enter $.linked in the Path to Metadata in Response field to preserve it alongside each record.

You do not need to add the GlassFrog authentication header manually—the X-Auth-Token header is handled automatically by Nexla based on your credential configuration. For a full reference of available endpoints and supported query parameters, refer to the GlassFrog API documentation and the GlassFrog API v3 Postman reference.

Once all of the relevant settings have been configured, click the Create button in the upper right corner of the screen to save and create the new GlassFrog API data source. Nexla will now begin ingesting data from the configured endpoint and will organize any data that it finds into one or more Nexsets.

Use as a destination

Click the + icon on the Nexset that will be sent to the GlassFrog API destination, and select the Send to Destination option from the menu. Select the GlassFrog API connector from the list of available destination connectors, then select the credential that will be used to connect to the GlassFrog organization, and click Next; or, create a new GlassFrog API credential for use in this flow.

Endpoint templates

Nexla provides pre-built templates that can be used to rapidly configure destinations to send data to common GlassFrog API endpoints. Select the endpoint to which this destination will send data from the Endpoint pulldown menu, then click on a template below to expand it and view configuration details.

Create Person

Creates a new member in the GlassFrog organization with the provided name, email, and optional external ID.

• Sends a POST request to https://api.glassfrog.com/api/v3/people with the person payload.
• Each record should include the person's name and email address at minimum.

The email address must be unique within the organization. Newly created people can then be assigned to roles using the Assign Person to Role endpoint.

Update Person

Updates an existing GlassFrog organization member's name, email, or external ID.

• Sends a PATCH request to https://api.glassfrog.com/api/v3/people/{id} with the updated fields.
• Configure the following parameter: Id — the unique identifier of the person to update.

Only the fields included in the payload will be updated. Use the Get Person source endpoint to retrieve current values before making changes.

Remove Person from Organization

Removes a person from the GlassFrog organization, revoking their access and removing their role assignments.

• Sends a DELETE request to https://api.glassfrog.com/api/v3/people/{id} for the specified person.
• Configure the following parameter: Id — the unique identifier of the person to remove.

This action is irreversible and will remove all role assignments for the person. Use the Get Person source endpoint to confirm the correct ID before proceeding.

Assign Person to Role

Assigns a person to a role within a specific circle in GlassFrog, creating a new role assignment record.

• Sends a POST request to https://api.glassfrog.com/api/v3/assignments with the assignment payload.
• Each record should include the person ID, role ID, and optionally an election date.

Use the List Circles and List Role Assignments source endpoints to retrieve valid circle, role, and person IDs.

Remove Person from Role Assignment

Removes a person from a specific role assignment by its ID.

• Sends a DELETE request to https://api.glassfrog.com/api/v3/assignments/{id} for the specified assignment.
• Configure the following parameter: Id — the unique identifier of the assignment to remove.

Use the List Role Assignments source endpoint to retrieve valid assignment IDs. This removes only the specified assignment, not the person or role.

Create Circle

Creates a new circle in the GlassFrog organization for structuring governance and role groupings.

• Sends a POST request to https://api.glassfrog.com/api/v3/circles with the circle configuration payload.
• Each record should include the circle name and optionally a parent circle ID and purpose statement.

Use the List Circles source endpoint to retrieve valid parent circle IDs for nested circle creation.

Update Circle

Updates an existing GlassFrog circle's properties such as its name, purpose, or strategy.

• Sends a PATCH request to https://api.glassfrog.com/api/v3/circles/{id} with the updated circle properties.
• Configure the following parameter: Id — the unique identifier of the circle to update.

Only the fields included in the payload will be updated. Use the List Circles source endpoint to retrieve valid circle IDs.

Delete Circle

Deletes a GlassFrog circle by its unique identifier. This removes the circle and its associated roles from the organization structure.

• Sends a DELETE request to https://api.glassfrog.com/api/v3/circles/{id} for the specified circle.
• Configure the following parameter: Id — the unique identifier of the circle to delete.

Deleting a circle will also remove any roles defined within it. This action is irreversible.

Create Role

Creates a new role within a GlassFrog circle, defining a new governance function with purpose, domains, and accountabilities.

• Sends a POST request to https://api.glassfrog.com/api/v3/roles with the role definition payload.
• Each record should include the role name, parent circle ID, and optionally purpose and accountability descriptions.

Use the List Circles source endpoint to retrieve valid circle IDs for assigning the new role to the correct circle.

Update Role

Updates an existing GlassFrog role's name, purpose, accountabilities, or domains.

• Sends a PATCH request to https://api.glassfrog.com/api/v3/roles/{id} with the updated role properties.
• Configure the following parameter: Id — the unique identifier of the role to update.

Only the fields included in the payload will be updated. Use the Get Role source endpoint to retrieve the current role definition.

Delete Role

Deletes a role from a GlassFrog circle by its unique identifier.

• Sends a DELETE request to https://api.glassfrog.com/api/v3/roles/{id} for the specified role.
• Configure the following parameter: Id — the unique identifier of the role to delete.

Deleting a role removes it from the circle along with all associated accountabilities and domains. Existing role assignments for this role will also be removed.

Create Project

Creates a new project within a GlassFrog circle or role, capturing a desired outcome and its current status.

• Sends a POST request to https://api.glassfrog.com/api/v3/projects with the project payload.
• Each record should include the project description and the owning circle or role ID.

Use the List Circles source endpoint to retrieve valid circle IDs for the project owner.

Update Project

Updates an existing GlassFrog project's description, status, or other properties.

• Sends a PATCH request to https://api.glassfrog.com/api/v3/projects/{id} with the updated project fields.
• Configure the following parameter: Id — the unique identifier of the project to update.

Use the Get Project source endpoint to retrieve current project values before making updates.

Delete Project

Permanently deletes a GlassFrog project by its unique identifier.

• Sends a DELETE request to https://api.glassfrog.com/api/v3/projects/{id} for the specified project.
• Configure the following parameter: Id — the unique identifier of the project to delete.

This action is irreversible. Use the Get Project source endpoint to confirm the correct project before deleting.

Create Action

Creates a new next-action or tension in GlassFrog, capturing a discrete task or governance tension from a tactical meeting.

• Sends a POST request to https://api.glassfrog.com/api/v3/actions with the action payload.
• Each record should include the action description and the owning person or role ID.

Actions represent discrete next steps. Tensions represent governance issues to be processed in a governance meeting.

Create Metric

Creates a new metric for a GlassFrog role or circle to be tracked in tactical meetings.

• Sends a POST request to https://api.glassfrog.com/api/v3/metrics with the metric definition payload.
• Each record should include the metric description, frequency, and owning role or circle ID.

Metrics are reported on during tactical meetings. Frequency options typically include weekly, monthly, or quarterly.

Update Metric

Updates an existing GlassFrog metric's description, owning role, or frequency.

• Sends a PATCH request to https://api.glassfrog.com/api/v3/metrics/{id} with the updated metric fields.
• Configure the following parameter: Id — the unique identifier of the metric to update.

Use the Get Metric source endpoint to retrieve the current metric values before making updates.

Delete Metric

Permanently deletes a GlassFrog metric by its unique identifier.

• Sends a DELETE request to https://api.glassfrog.com/api/v3/metrics/{id} for the specified metric.
• Configure the following parameter: Id — the unique identifier of the metric to delete.

This action is irreversible. The metric will be permanently removed from the circle's tactical meeting agenda.

Update Checklist Item

Updates an existing GlassFrog checklist item's description or associated role.

• Sends a PATCH request to https://api.glassfrog.com/api/v3/checklist_items/{id} with the updated checklist item fields.
• Configure the following parameter: Id — the unique identifier of the checklist item to update.

Use the Get Checklist Item source endpoint to retrieve the current values before making updates.

Delete Checklist Item

Permanently deletes a GlassFrog checklist item by its unique identifier.

• Sends a DELETE request to https://api.glassfrog.com/api/v3/checklist_items/{id} for the specified checklist item.
• Configure the following parameter: Id — the unique identifier of the checklist item to delete.

This action is irreversible. The checklist item will be permanently removed from the circle's tactical meeting agenda.

Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to send a test payload. The result will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the destination is configured correctly before saving.

Manual configuration

GlassFrog API destinations can also be manually configured to send data to any valid GlassFrog API v3 endpoint. You can also configure Nexla to automatically send the response received from the GlassFrog API after each call to a new Nexla webhook data source. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, data format, endpoint URL, request headers, attribute exclusions, record batching, and response webhooks.

GlassFrog API v3 accepts and returns JSON, so select JSON as the Content Format. Use POST to create new resources (such as projects or actions), PATCH to partially update existing resources, and DELETE to remove resources. For update or delete operations, include the ID of the resource at the end of the URL (e.g., https://api.glassfrog.com/api/v3/projects/12345); for create operations, use the collection endpoint (e.g., https://api.glassfrog.com/api/v3/projects). You do not need to add the GlassFrog authentication header manually—the X-Auth-Token header is handled automatically by Nexla based on your credential configuration. For a complete reference of GlassFrog API v3 write endpoints and required request body structures, refer to the GlassFrog API documentation and the GlassFrog API v3 Postman reference.

Save & activate

Once all endpoint settings have been configured, click the Done button in the upper right corner of the screen to save and create the destination. To send the data to the configured GlassFrog API endpoint, open the destination resource menu, and select Activate.

The Nexset data will not be sent to the GlassFrog API endpoint until the destination is activated. Destinations can be activated immediately or at a later time, providing full control over data movement.