Skip to main content

Authorization

Follow this guide to create a new Coda credential that will allow Nexla to authenticate to and exchange data with your Coda account.
coda_api_auth.png

Coda

Prerequisites​

Before creating a Coda credential, you'll need to obtain an API token from your Coda account. The Coda API uses Bearer token authentication with API tokens.

Coda Account Setup​

To obtain the required API token for Coda:

  1. Sign in to Coda: Navigate to https://coda.io/ and sign in to your Coda account. If you don't have an account, you can create one by clicking Sign up and following the registration process.

  2. Access API Settings: Once signed in, navigate to your account settings. Click on your profile icon in the top right corner, then select Account Settings from the menu.

  3. Navigate to API Settings: In the Account Settings page, look for the API section or navigate directly to https://coda.io/account/apiSettings.

  4. Generate API Token: In the API Settings page, you'll see options to manage your API tokens. Click the Generate API Token button or similar option to create a new token.

  5. Name and Create Token: Provide a descriptive name for your API token (e.g., "Nexla Integration") to help identify its purpose. Click Create or Generate to create the token.

  6. Copy API Token: After creation, copy the API token immediately. Coda API tokens are only displayed once for security reasons. Store this token securely, as you'll need it when creating the credential in Nexla.

Coda API tokens are sensitive credentials that provide access to your Coda account and documents. Keep these tokens secure and never share them publicly or commit them to version control systems. The API token is used in the Authorization header as Bearer {token} for all API requests.

API Access Requirements​

Coda API access requires:

  • Valid Coda Account: You must have an active Coda account
  • API Token: An API token generated from your account settings
  • Document Access: The API token will have access to documents that you have permission to access in your Coda account

The Coda API uses Bearer token authentication, where the API token is sent in the Authorization header with the format Bearer {token}. All API requests must use HTTPS.

For complete information about Coda API authentication and getting started, see the Coda API Documentation.

Create a Coda Credential​

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

New Credential Overlay – Coda

CodaCred.png

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 Token Configuration​

  1. API Token: Enter your Coda API token in the API Token field. This is the secret token that authenticates your application with the Coda API. You can obtain this token from https://coda.io/account/apiSettings in your Coda account settings.

The API token is sensitive information that should be kept secure. Nexla will store this credential securely and use it only for API authentication purposes. The token is sent in the Authorization header as Bearer {token} for all Coda API requests.

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.