> For the complete documentation index, see [llms.txt](https://village-labs.gitbook.io/coworker-product-and-developer-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://village-labs.gitbook.io/coworker-product-and-developer-docs/data-connections/airtable.md).

# 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="/files/fdOnmu7WoQC3taDeRi3J" 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="/files/0ZJzOYkJopC5IojEOIn5" 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="/files/UnVIvGTo9OOfb6Fhj1qq" 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://village-labs.gitbook.io/coworker-product-and-developer-docs/data-connections/airtable.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.