Sync list build to table

This page documents the canonical HTTP contract for this endpoint.

This is the first-class handoff from sourced list results into a Smart Table. Use it instead of reshaping list-build results locally and inserting rows manually.

For company lists, identity_key: "auto" selects the source-aware company identity: catalog companies use the global company ID, similar-company results use company domain, and other company results use LinkedIn company identity. For lead lists, auto uses LinkedIn profile URL. Use explicit domain only when results include reliable company domains.

Path parameters

job_idrequired
string
List-build job ID. The job must be completed unless allow_partial is true.

Name	Type	Description
job_idrequired	string	List-build job ID. The job must be completed unless allow_partial is true.

Body parameters

type · optional
string
items, companies, leads, jobs, businesses, or all. Defaults to the job kind.
table_id · optional
string
Existing Smart Table ID for append/upsert mode.
table_name · optional
string
New Smart Table name when creating a table.
table_mode · optional
string
create or append. Inferred from table_id when omitted.
identity_key · optional
string
auto, linkedin_url, linkedin_company_id, linkedin_company_url, or domain. Default: auto.
dedupe_mode · optional
string
allow, skip, or upsert. Default: upsert.
merge_mode · optional
string
fill_empty or overwrite_mapped. Default: fill_empty.
allow_partial · optional
boolean
Allow syncing before the list-build job is completed. Default: false.
presentation · optional
object
Optional result projection settings with include_fields: string[].

Name	Type	Description
type	string	items, companies, leads, jobs, businesses, or all. Defaults to the job kind.
table_id	string	Existing Smart Table ID for append/upsert mode.
table_name	string	New Smart Table name when creating a table.
table_mode	string	create or append. Inferred from table_id when omitted.
identity_key	string	auto, linkedin_url, linkedin_company_id, linkedin_company_url, or domain. Default: auto.
dedupe_mode	string	allow, skip, or upsert. Default: upsert.
merge_mode	string	fill_empty or overwrite_mapped. Default: fill_empty.
allow_partial	boolean	Allow syncing before the list-build job is completed. Default: false.
presentation	object	Optional result projection settings with include_fields: string[].

Errors

Status	Meaning
400	List build must be completed, table_mode is invalid, or destination table is missing.
401	Invalid API key or missing auth.
403	Missing tables:write scope or no access to destination table.
404	List build job not found.

Example

bash

curl -X POST "https://app.autotouch.ai/api/list-builds/lb_1234567890abcdef12345678/sync-to-table" \
  -H "Authorization: Bearer stk_your_key_id.your_secret" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "companies",
    "table_name": "Sourced Accounts",
    "identity_key": "auto",
    "dedupe_mode": "upsert"
  }'

Request body

json

{
  "type": "companies",
  "table_name": "Sourced Accounts",
  "identity_key": "auto",
  "dedupe_mode": "upsert",
  "merge_mode": "fill_empty"
}

Response example

json

{
  "sync_job_id": "lbs_1234567890abcdef12345678",
  "list_build_job_id": "lb_1234567890abcdef12345678",
  "table_id": "507f1f77bcf86cd799439011",
  "table_name": "Sourced Accounts",
  "type": "companies",
  "status": "queued",
  "stage": "queued",
  "progress": 0,
  "identity_key": "linkedin_company_id",
  "dedupe_mode": "upsert"
}