Sources

Sources feed data INTO tables. Webhook sources provide a URL to POST data, API pull sources fetch on a schedule, connected table sources flow rows from another table.

Source Types

Type	What It Does
`webhook`	Provides a URL to POST data into the table
`csv_import`	Upload CSV files to create rows
`api_pull`	Fetch data from an external API on a schedule
`connected_table`	Flow rows from another hypertab table via filter
`manual`	Manually managed, no automatic ingestion

Create Source

POST/api/tables/:tableId/sourceshypertab_create_source

Create a data source for a table.

Parameter	Type	Description
`table`required	`string`	Table name or ID
`type`required	`string`	webhook, csv_import, api_pull, manual, or connected_table
`name`	`string`	Human-readable source name (max 128 chars)
`config`	`object`	Type-specific config (see examples below)

Webhook Source

Creates a unique URL. External services POST data to this URL to create rows.

{
  "tool": "hypertab_create_source",
  "arguments": {
    "table": "leads",
    "type": "webhook",
    "name": "Typeform submissions",
    "config": {
      "field_mapping": {
        "form_fields.email": "email",
        "form_fields.name": "full_name"
      }
    }
  }
}

API Pull Source (scheduled)

{
  "tool": "hypertab_create_source",
  "arguments": {
    "table": "deals",
    "type": "api_pull",
    "name": "CRM sync",
    "config": {
      "url": "https://api.crm.com/deals",
      "method": "GET",
      "headers": { "Authorization": "Bearer CRM_TOKEN" },
      "schedule": "0 */6 * * *"
    }
  }
}

Connected Table Source

{
  "tool": "hypertab_create_source",
  "arguments": {
    "table": "qualified_leads",
    "type": "connected_table",
    "name": "From leads (score >= 80)",
    "config": {
      "source_table": "leads",
      "filter": { "score": { "gte": 80 } }
    }
  }
}

List Sources

GET/api/tables/:tableId/sourceshypertab_list_sources

List sources for a table (or all tables). Shows source type, status, row count, and last run time.

Parameter	Type	Description
`table`	`string`	Table name or ID (omit to list all sources)

{ "tool": "hypertab_list_sources", "arguments": { "table": "leads" } }

Delete Source

DELETE/api/sources/:sourceIdhypertab_delete_source

Delete a source permanently. Requires confirm: true.

Parameter	Type	Description
`source_id`required	`string`	Source ID to delete
`confirm`required	`boolean`	Must be true to confirm deletion

{
  "tool": "hypertab_delete_source",
  "arguments": { "source_id": "src_abc123", "confirm": true }
}

Auto-Run

Webhooks