# Airtable

### Prerequisites

* An Airtable account with sufficient rights to generate API tokens.

### Generating the credentials

1. Log in to your Airtable account and go to the [Developer Hub](https://airtable.com/create/tokens).
2. Start the personal access token creation flow by clicking on "Create token".<br>

   <figure><img src="https://3561055466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcl1KIMhPQkmG41x5eGvL%2Fuploads%2FXtVNehgmO5hI6sD5TjcR%2FScreenshot%202024-04-05%20at%2017.30.35.png?alt=media&#x26;token=c14fbf70-e200-473a-8a94-1dafe8b64f11" alt=""><figcaption></figcaption></figure>
3. Give your personal access token a name, and configure the token's scopes so that it may have a read-only access on your data. Depending on the kind of activities you wish to connect to Coworker, you may restrict these scopes.<br>

   <figure><img src="https://3561055466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcl1KIMhPQkmG41x5eGvL%2Fuploads%2FAtBZ26eY0fPfAuypIDxd%2FScreenshot%202024-04-05%20at%2017.34.03.png?alt=media&#x26;token=f6bf837e-1e17-4e31-8729-7d70c164e55f" alt=""><figcaption></figcaption></figure>
4. Once you have created your token, copy it - it will only be displayed once.
5. Retrieve the ID of the table (base) you wish to synchronize: this ID can be retrieved from the Airtable URL.<br>

   <figure><img src="https://3561055466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcl1KIMhPQkmG41x5eGvL%2Fuploads%2FoSbrsEprfn7IYx1TJ1jw%2FScreenshot%202024-04-05%20at%2017.57.35.png?alt=media&#x26;token=bd2c7062-fd0c-41ac-8b47-5670a2c1c752" alt=""><figcaption></figcaption></figure>

### Information required for the Coworker connection:

* `base_id`: The ID of the Airtable base which needs to be synchronized. If multiple bases need to be synchronized, multiple connections will need to be created.
* `token`: The personal access token which has access to the above base. See the steps above to create it


---

# 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://village-labs.gitbook.io/coworker-product-and-developer-docs/data-connections/airtable.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.