Table

Attach a data source to a table

Attach a CSV, webhook, or CRM/API data source to a table.

  • crm requires dataset_id and optionally a schedule for recurring syncs.
  • webhook creates a webhook handler (+ raw JSON column) when webhook_id is omitted.
  • csv records a CSV source; rows are added via the row endpoints.
post/external/v1/table/{table_uuid}/sources

Request

  • Base URL
    https://api.databar.ai (the document declares no server; this is the origin it was published from)
  • Auth
    API key in header x-apikey

Path parameters

table_uuidstring uuid required

Request body

source_type'csv' | 'webhook' | 'crm' required
dataset_idinteger nullable

Catalogue Dataset id — required for crm sources.

webhook_idinteger nullable

Existing WebhookTable id to link (webhook sources only).

webhook_mode'raw_json' | 'mapping'

How a new webhook stores payloads, fixed at creation time. "raw_json" dumps each payload into a single JSON column and works with no further setup; "mapping" leaves the webhook unmapped so the first payload is kept as a sample — then call the webhook-fields and webhook-mapping endpoints to spread fields across columns.

scheduleobject nullable

Optional recurring-sync config for crm sources. Omit to connect the source with NO scheduler (no recurring pulls); only set it to enable scheduled syncs, e.g. {"cron_string": "0 0 * * *", "rows": 100, "overwrite": false}. WARNING: "overwrite": true clears the entire table before each sync.

Response

OK

idinteger required
source_typestring required
source_type_displaystring nullable
statusstring required
status_displaystring nullable
dataset_idinteger nullable
webhook_idinteger nullable
webhook_identifierstring nullable
webhook_based_integrationstring nullable
webhook_urlstring nullable
webhook_modestring nullable
schedule_task_idinteger nullable
error_messagestring nullable
namestring nullable
logostring nullable
records_countinteger nullable
last_synced_atstring nullable
created_atstring nullable
updated_atstring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.