Skip to main content

Authorization

Follow this guide to create a new Granola API credential that will allow Nexla to authenticate to and exchange data with your Granola workspace.
granola_api_auth.png

Granola API

Prerequisites​

To connect Nexla to the Granola API, you need a Granola API key. API keys are available to workspace members on Granola's Business and Enterprise plans.

Plan Requirements​

The Granola API is not available on free or individual plans. Before proceeding, confirm that your workspace is on a Business or Enterprise subscription. Additional details about Granola plans are available on the Granola pricing page.

Generate a Granola API Key​

Granola API keys are created from the workspace settings in your Granola account. Follow the steps below to generate one:

  1. Sign in to your Granola account at app.granola.ai.

  2. Open Settings by clicking your profile icon or workspace name in the application.

  3. Navigate to Workspaces, then select the API tab.

  4. Click Generate API Key to create a new key.

  5. Copy the generated API key immediately and store it in a secure location. Granola displays the full key value only once at the time of creation.

On Enterprise plans, workspace admins control which access scopes members can use when creating API keys. This setting is found in Settings → Workspace → General → API access for members. Confirm with your workspace administrator that the required scopes are enabled before generating a key.

Important

Store your API key securely as soon as it is generated. Granola does not display the full key value again after the initial creation screen. If the key is lost, you will need to generate a new one.

API Key Scopes​

Granola API keys support one or more access scopes, which define what data the key is permitted to access. When generating a key, select the scopes required for your use case:

  • Notes (read): Allows read access to meeting notes and transcripts—required for using Granola as a data source in Nexla.

For additional information about available scopes and their capabilities, refer to the Granola API documentation.

Create a Granola API Credential​

  • To create a new Granola API credential, after selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

Credential Name & Description​

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

    Resource descriptions are recommended but are not required. They should be used to provide information about the resource purpose, data freshness, etc. that can help the owner and other users efficiently understand and utilize the resource.

API Key​

  1. Enter the Granola API key you generated in the API Key field. This key authenticates all Nexla requests to the Granola API on your behalf. The key is transmitted securely and stored in encrypted form.

    Granola API keys begin with the prefix grn_. Ensure you are pasting the complete key value, including the prefix, into this field.

Save the Credential​

  1. Once all of the relevant steps in the above sections have been completed, click the Save button at the bottom of the overlay to save the configured credential.

  2. 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.