> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adriel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to connect

> How to connect the Airtable data source to Adriel: authorize an Airtable account, grant base access, and select a table.

Airtable is a collaborative database platform for bases, tables, and records. Connecting it brings the records of a selected Airtable table into Adriel, where operational datasets such as campaign trackers, creative inventories, and partner contact lists can be blended with platform-native marketing data on a dashboard.

## Before you connect

The following are required:

* An Airtable account with access to the target base and table.
* Permission to authorize third-party apps. A standard Airtable user role is sufficient.
* A decision on which bases to grant access to during the authorization step. Only bases granted during consent are available when creating the data source.

## Connect Airtable

<Steps>
  <Step title="Grant access to the bases">
    On the **Data Sources** page, search for **Airtable** and select it. Sign in to the Airtable account in the pop-up window. When the access window appears, click **+ Add a base** to choose which bases and workspace to grant access to, then click **Grant access** once the selection is complete.
  </Step>

  <Step title="Choose the base and table">
    On the data source settings, choose the **Base**, then select one or more **Tables**. Each selected table becomes a separate Adriel data source that shares the same Airtable connection.
  </Step>

  <Step title="Submit">
    Click **Submit** to complete the connection. Initial data availability can take up to one business day.
  </Step>
</Steps>

## What gets imported

The connector imports the records of each selected table, exposing every column as a field. Numeric columns (number, currency, percent, count, rating, duration) come in as metrics; text, single-select, multi-select, collaborator, linked-record, and attachment columns come in as breakdowns. Multi-select and linked-record values are joined into text, and an attachment column resolves to the URL of its first attachment only.

For the complete field list and column-type mapping, see the [Airtable data reference](/data-sources/a-f/airtable/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="A base is missing from the picker">
    The base was not selected during the authorization step. Reconnect and grant access to the base, then create the data source.
  </Accordion>

  <Accordion title="Sync stops with an authentication failure after a long pause">
    The Airtable refresh token has expired. Refresh tokens have a long but finite lifetime. Reconnect the data source to issue a new token.
  </Accordion>

  <Accordion title="A multi-select or linked-record column looks unexpected on the dashboard">
    Multi-select values are imported as joined text, linked records resolve to the primary field of the linked record, and attachments resolve to the URL of the first attachment only. Restructure the source column or pick a different column when finer detail is needed.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Airtable data reference" href="/data-sources/a-f/airtable/data-reference">
    Fields, column-type mapping, and limits for Airtable.
  </Card>

  <Card title="Airtable FAQs" href="/data-sources/a-f/airtable/faqs">
    Common questions and expected behaviors for the Airtable data source.
  </Card>

  <Card title="How to connect Google Sheets" href="/data-sources/g-n/google-sheets/how-to-connect">
    Connect an alternative spreadsheet data source.
  </Card>

  <Card title="How to connect Notion" href="/data-sources/g-n/notion/how-to-connect">
    Connect an alternative structured-data platform.
  </Card>
</CardGroup>