# 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](/product-documentation/connectors-and-instances/working-with-instances/adding-an-instance.md) using **token** authentication, the credentials below are prompted:

{% tabs %}
{% tab title="Required credentials" %}
When a user chooses to [add a connector instance](/product-documentation/connectors-and-instances/working-with-instances/adding-an-instance.md) 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.wearepatchworks.com/product-documentation/connectors-and-instances/patchworks-connectors/airtable-prebuilt-connector.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.