Airtable
Get OAuth Authorize URL
Build the Airtable authorization URL that starts the connect flow. Open the returned authorization_url in a browser so the account owner can grant access; Airtable then redirects back to SKU.io to finish the connection. Pass the optional instance_id query parameter to re-authorize an existing connection instead of creating a new one.
List Airtable Connections
List the Airtable connections for the current account, including connection status, the granting Airtable account, granted scopes, and monthly API usage against the plan cap.
Verify Connection
Verify a connection by calling Airtable with the stored token and returning the connected Airtable account id, email, and the scopes granted to the connection.
Disconnect Airtable
Disconnect an Airtable connection. This revokes the stored token and removes every dataset mapping that belonged to the connection.
List Syncable Datasets
List the catalog of SKU.io datasets that can be synced to Airtable. Each dataset lists the exportable fields available to map (with the target cell type) and whether it accepts inbound changes back from Airtable.
List Airtable Bases
List the Airtable bases the connection can access, with the permission level granted for each base.
List Base Tables
List the tables in an Airtable base along with each table's fields. Use the field ids to build a mapping's key field and field map.
List Mappings
List the dataset mappings configured on a connection, with their target base and table, sync schedule, last sync result, and error count.
Create Mapping
Create a dataset mapping that syncs a SKU.io dataset to a table in an Airtable base.
Update Mapping
Update an existing dataset mapping. Send only the fields you want to change; omitted fields keep their current value.
Delete Mapping
Delete a dataset mapping. This stops future syncs for the mapping; records already written to Airtable are left in place.
Sync Mapping
Trigger a sync run for a mapping now. The sync runs in the background; the response returns a tracked_job_log_id you can use to follow its progress.
Provision Template Table
Provision a ready-made Airtable base for the connection. This creates a pre-built base with tables and mappings for common datasets and runs an initial backfill in the background.
List Inbound Changes
List the queued inbound changes proposed from Airtable and awaiting review. Each change targets a SKU.io record (product, sales order, or supplier): link_type/link_id identify it, link_reference and link_route present it for navigation, and proposed lists each mapped field's old and new value. Apply or reject them from the review queue.
Apply Inbound Changes
Apply queued inbound changes back into SKU.io. Send 'all': true to apply every pending change for the connection, or 'ids': [..] to apply specific changes. Changes are applied in the background; the response returns a tracked_job_log_id to follow progress.
Reject Inbound Changes
Reject queued inbound changes so they are not applied. Send 'all': true to reject every pending change for the connection, or 'ids': [..] to reject specific changes.