# Airtable (prebuilt connector)

## Description

**Airtable** is a single platform which empowers teams to build custom apps on top of shared data. 

## API documentation

Airtable's API documentation (used to build this connector) can be found via the link below:

{% embed url="<https://airtable.com/developers/web/api/introduction>" %}

## Authentication&#x20;

When adding connector instances for Airtable, the following authentication methods are supported:

* [Token authentication](#token-authentication)

### Token authentication

When a user chooses to [add a connector instance](https://doc.wearepatchworks.com/product-documentation/connectors-and-instances/working-with-instances/adding-an-instance) using **token** authentication, the credentials below are prompted:

{% tabs %}
{% tab title="Required credentials" %}
When a user chooses to [add a connector instance](https://doc.wearepatchworks.com/product-documentation/connectors-and-instances/working-with-instances/adding-an-instance) using **token** authentication, the credentials below are prompted:

<table><thead><tr><th width="221">Credential</th><th width="137" data-type="checkbox">Required?</th><th>Notes</th></tr></thead><tbody><tr><td><code>token</code></td><td>true</td><td>Your <a href="https://support.airtable.com/docs/creating-and-using-api-keys-and-access-tokens#personal-access-tokens-basic-actions">personal access token for Airtable</a>.</td></tr><tr><td><code>base id</code></td><td>true</td><td>The id associated with the base you want to use for this connection.</td></tr><tr><td><code>table id</code> </td><td>true</td><td>The id associated with whichever table  within the base that you want to use for this connection.</td></tr></tbody></table>
{% endtab %}

{% tab title="Obtaining credentials" %}
**Obtaining a token**

Personal access tokens are created from Airtable. Please refer to the Airtable documentation: [Personal Access Tokens basic actions](https://support.airtable.com/docs/creating-and-using-api-keys-and-access-tokens#personal-access-tokens-basic-actions).

**Obtaining the base id and table id**

Base and table ids are available from the Airtable API page associated with your Airtable base. Open the [Airtable Standard API](https://airtable.com/api) page and click the Airtable base that you want to use - from here you'll see API information associated with the base, which includes `base` and `table` ids.
{% endtab %}
{% endtabs %}