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

# List tables

> List tables and fields for a base (for picking `tableId` / `columnId`).



## OpenAPI

````yaml /openapi.json get /airtable/listTables
openapi: 3.0.4
info:
  title: Simplified Webhooks Backend
  version: '1.0'
  description: >-
    API for Airtable webhooks, usage (record & storage counts), and
    change-monitoring audit logs.
  contact:
    name: API Support
    url: https://www.simplified-webhooks.com/contact-us
    email: contact@simplified-webhooks.com
  x-generated: backend/scripts/generate-openapi.ts — do not edit by hand
servers:
  - url: https://api.simplified-webhooks.com
    description: Main server
security: []
tags:
  - name: Webhooks
    description: Receive Airtable change notifications at your own HTTPS URL.
  - name: Usage
    description: Daily record counts and attachment storage for your Airtable bases.
  - name: Audit Log
    description: >-
      Log record and schema changes into a Changes table in your own Airtable
      Monitoring Base.
  - name: Airtable Helpers
    description: Look up base, table, and field ids from your connected Airtable account.
paths:
  /airtable/listTables:
    get:
      tags:
        - Airtable Helpers
      summary: List tables
      description: List tables and fields for a base (for picking `tableId` / `columnId`).
      operationId: listAirtableTables
      parameters:
        - schema:
            type: string
            minLength: 1
          required: true
          name: baseId
          in: query
      responses:
        '200':
          description: Tables and fields from Airtable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AirtablePassThrough'
        '400':
          description: Missing `baseId` or Airtable connection error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectionErrorResponse'
        '401':
          description: >-
            Not authenticated, or Airtable needs to be reconnected
            (`oauth_reconnect_required`).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectionErrorResponse'
        '500':
          description: Failed to list tables.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - apiKey: []
components:
  schemas:
    AirtablePassThrough:
      type: object
      properties: {}
      additionalProperties:
        nullable: true
      description: >-
        Airtable Meta API response body, returned unchanged. Shape is owned by
        Airtable.
    ConnectionErrorResponse:
      type: object
      properties:
        message:
          type: string
        code:
          type: string
      required:
        - message
        - code
      additionalProperties: false
    ErrorResponse:
      type: object
      properties:
        message:
          type: string
        code:
          type: string
      required:
        - message
      additionalProperties: false
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      bearerFormat: sk_...
      description: >-
        Your Simplified Webhooks API key, sent as a bearer token:
        `Authorization: Bearer sk_...`. Create API keys in your [profile
        settings](https://www.simplified-webhooks.com/profile-settings).

````