Airtable

Secure, streamlined access to the Airtable API for your team.

Overview

The Stacksync Airtable API Proxy provides centralized access to Airtable APIs through a single HTTPS endpoint. You authenticate with your Stacksync service token. Stacksync manages the underlying Airtable OAuth connection.

Use it for on‑demand operational tasks and low‑volume reads/writes. For continuous, high‑volume sync, use Stacksync Syncs instead.

Operations:

• Pass Through

• Attachements

Pass Through

The Airtable Pass Through operation is the primary way to interact with Airtable through the Stacksync API Proxy. It lets you invoke any Airtable API endpoint that supports your configured authentication by specifying the full Airtable URL, HTTP method, and optional request body.

Use this operation for all Airtable use cases, including working with bases, tables, records, views, and custom fields, as well as newly released endpoints. Authentication and routing are managed by Stacksync, so your services, scripts, and internal tools can call Airtable securely with a single integration pattern, without embedding Airtable credentials or implementing authentication flows in each system.

curl -X [GET | POST | PUT | PATCH | DELETE] \
  https://eu.api-proxy.stacksync.com/v1/proxy/INSERT_REQUEST_URL_HERE \
  -H "Authorization: Bearer your_api_proxy_service_token" \
  -d 'Optional'

Example request

Read records from a table

cURL

curl -X GET "https://eu.api-proxy.stacksync.com/v1/proxy/https://api.airtable.com/v0/<baseId>/<tableId>?maxRecords=5&view=Grid%20view" \
  -H "Authorization: Bearer your_api_proxy_service_token"

Python

Javascript

cURL

curl -X GET "https://eu.api-proxy.stacksync.com/v1/proxy/https://api.airtable.com/v0/<baseId>/<tableId>?maxRecords=5&view=Grid%20view" \
  -H "Authorization: Bearer your_api_proxy_service_token"

Python

Javascript

Example response

{
  "records": [
    {
      "id": "recXXXXXXXXXXXXXX",
      "createdTime": "2023-07-28T15:01:14.000Z",
      "fields": {
        "Name": "Sample Record 1",
        "Status": "In Progress",
        "Email": "[email protected]",
        "Amount": 1000,
        "Due Date": "2024-07-31",
        "Tags": ["Important", "Client"]
      }
    },
    {
      "id": "recYYYYYYYYYYYYYY",
      "createdTime": "2024-07-28T15:19:21.000Z",
      "fields": {
        "Name": "Sample Record 2",
        "Status": "Completed",
        "Email": "[email protected]",
        "Amount": 4000,
        "Due Date": "2024-07-25",
        "Tags": ["Important", "Partner"]
      }
    }
  ],
  "offset": "itrXXXXXXXXXXXXXX"
}

Attachements

Airtable provides signed URLs for attachments that expire after approximately 2 hours. This endpoint solves that problem by providing persistent URLs that automatically redirect to fresh Airtable-signed URLs.

This is to be used along a Stacksync syncs, more details here.

cURL

curl -X GET "https://eu.api-proxy.stacksync.com/v1/airtable_attachment?dt=eyJiYXNlX2lXUGdEIiwgInBhdGgiOiAiIn0=" \
  -H "Authorization: Bearer your_api_proxy_service_token"

Python

Javascript

The API proxy will then:

• Fetch the current attachment URL from Airtable

• Redirect you to the updated link automatically