# Airtable

## Setup Guide

You'll need the following information to set up your Airtable App with Kolla Konnect:

* Client ID
* Client Secret
* Scopes needed

### Prerequisites

You will need to have an Airtable account. You can get a free one here: <https://airtable.com/signup>

### Register your integration with Airtable

1. Go to the [OAuth Integrations](https://airtable.com/create/oauth) page
2. Click on "Register an OAuth Integration"
3. Add your integration name and set the redirect URL to the Kolla OAuth2 redirect URL:\
   `https://connect.getkolla.com/oauth`
4. Click the `Register Integration` button
5. Note the **Client ID** for later instructions

### Configure Your Airtable Integration

1. After registering your integration, you will be on the integrations details page. Scroll down to `Developer Details`
2. Click on `Generate Client Secret` and note it for later
3. Scroll down to Scopes section and choose the scopes you will need for your integration. *Note them for later.*

{% hint style="warning" %}
For you to connect to your customers' Airtable accounts you will need to provide your support email, privacy policy, and terms of service in your integration settings.
{% endhint %}

### Add your Airtable integration to Kolla

1\. In the Kolla Admin portal go to **Integrations > Connectors** and click **Add Connector**.

2\. Choose `Airtable` from the catalog of connectors

3\. Name your instance of this connector and input the following configuration items:

* **Client ID:** Obtained from the Airtable Oauth Integration page
* **Client Secret:** Obtained from the Airtable Oauth Integration page
* **Scopes:** Choose the scopes you selected in your Airtable integration

## Connecting to Airtable

You can find the documentation for Airtable [here](https://airtable.com/developers/web/api/introduction)


---

# 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://docs.getkolla.com/kolla/connector-guides/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.
