Using Builder Hub in Airtable

What is Builder Hub and what does it control?

Builder Hub is your centralized surface in Airtable to manage aspects related to App library and Development features that correspond to your organization and account.

• Library (Enterprise Scale only) - Learn more about managed apps and components here

  • Managed apps - Create or edit apps managed by builders across your organization

  • Components - Create or edit individual app components managed by builders across your organization

• Development

  • Personal access tokens - Personal access tokens grant permission to read and write data via the Airtable API

  • OAuth integrations - OAuth integrations let users grant your service or application API access to their Airtable data

  • Secrets - Secrets are used to securely store sensitive information like API keys and passwords. These can be utilized in scripting extensions or “Run a script” automation actions.

Registering OAuth integrations in Builder Hub

1. Navigate to your OAuth integrations page. (Must be logged into Airtable)

2. Click the Register an OAuth integration button.

3. Under “Name” type in a name for this OAuth integration.

4. Under “OAuth redirect URL” enter the URL where you want to redirect users.

5. Click Register integration.

6. This will bring you to a new screen. In the “About your integration” section fill in optional details in the “Tagline” and “Homepage URL” fields and add an optional logo for the integration.

7. In the “Developer details” section, you will see your “Client ID” and the “OAuth redirect URL” you configured on the initial setup page. You can also generate an optional “Client secret” when you are requesting tokens from a server.

8. The “Scopes” section allows you to define the permissions of your integration. As you select the various scopes described below, a preview of the authorization page where an end user will see a list of what the integration can access on behalf of the user.

   1. “Record data and comments” allows you to set read and write permissions at both the record and comment levels.

   2. “Base schema” allows you to set read and write permissions at the base level.

   3. “User metadata” allows you to set read permissions so that a user’s email data can be passed.

   4. “Advanced developer features” allows you to set manage permissions for base webhooks.

9. In the “Support information” information section, you will input a “Support email” address as well as a “Privacy policy URL” and “Terms of service URL.” These fields must be completed to allow other Airtable users the ability to authorize the integration.

10. Click Save changes.

To Edit, Disable, or Delete an OAuth integration:

1. Navigate to your OAuth integrations page.

2. Click the three dot icon to the far right side of the integration you want to alter.

3. From there, you’ll find the option to Edit integration, Disable integration, or Delete integration.

   1. A confirmation window will appear when you attempt to disable or delete an integration. Click Disable or Delete to confirm.

Creating secrets in Builder Hub

1. Navigate to your Secrets page. (Must be logged into Airtable)

2. Click the Create secret button.

3. Give the secret a name. Usually this is something somewhat descriptive so that in the future you will know what the secret has access to and/or the surface in Airtable where it is being utilized.

4. In the “Value” field, type the secret passcode of your choosing.

5. In the “Collaborators” section, you will choose who can use the secret. By default, only you will be able to utilize the secret. Customers on Business or Enterprise Scale plans can also choose to allow one or more specific user groups access to use the secret. You can even set up a secret for a user group within your organization that you do not belong to.

6. Click Create secret.

To Edit or Delete a secret:

1. Navigate to your Secrets page.

2. Click the three dot icon to the far right side of the secret you want to alter.

3. From there, you’ll find the option to Edit secret or Delete secret.

   1. A confirmation window will appear when you attempt to delete a secret. Click Delete to confirm.