Update table webhook ingest settings

This page documents the canonical HTTP contract. Switch to the CLI example when you want the operator workflow.

Unknown settings are ignored. When duplicate_mode is skip or upsert, match_rule_id must point to a column that supports incoming matching; its identity strategy is authoritative. Changing the match column clears an omitted stale strategy. This route updates configuration and does not ingest a record.

Path parameters

table_idrequired
string
Target table ID.

Name	Type	Description
table_idrequired	string	Target table ID.

Body parameters

match_rule_id · optional
string|null
Optional match rule id or column key. Required when duplicate_mode is skip or upsert; it must identify a supported incoming-match column.
match_column · optional
string|null
Alias for match_rule_id; ignored when match_rule_id is also supplied.
match_strategy · optional
string|null
Optional strategy: domain, email, linkedin_url, external_id, or exact_text. With duplicate protection enabled, source column semantics determine the strategy.
duplicate_mode · optional
string
allow (default), skip, or upsert. skip/upsert require a valid match_rule_id; unsupported modes return 422.
merge_mode · optional
string
fill_empty (default) or overwrite_mapped. Other values return 422.
event_stream_sample_capture_enabled · optional
boolean
Enable or disable capture of the next incoming sample for event-stream setup. Enabling resets prior sample state.

Name	Type	Description
match_rule_id	string\|null	Optional match rule id or column key. Required when duplicate_mode is skip or upsert; it must identify a supported incoming-match column.
match_column	string\|null	Alias for match_rule_id; ignored when match_rule_id is also supplied.
match_strategy	string\|null	Optional strategy: domain, email, linkedin_url, external_id, or exact_text. With duplicate protection enabled, source column semantics determine the strategy.
duplicate_mode	string	allow (default), skip, or upsert. skip/upsert require a valid match_rule_id; unsupported modes return 422.
merge_mode	string	fill_empty (default) or overwrite_mapped. Other values return 422.
event_stream_sample_capture_enabled	boolean	Enable or disable capture of the next incoming sample for event-stream setup. Enabling resets prior sample state.

Errors

Status	Meaning
401	Invalid API key or missing auth.
403	Missing tables:write scope or table access denied.
404	Table not found.
422	Invalid match_strategy, duplicate_mode, or merge_mode.
422	Invalid request body or field type.

Example

bash

curl -X PATCH "https://app.autotouch.ai/api/tables/67bd8c39c7d3e80f0a95b560/webhook/settings" \
    -H "Authorization: Bearer stk_your_key_id.your_secret" \
    -H "Content-Type: application/json" \
    -d '{
      "match_rule_id":"linkedin_url",
      "match_strategy":"linkedin_url",
      "duplicate_mode":"upsert",
      "merge_mode":"fill_empty"
    }'

Request body

json

{
    "match_rule_id": "linkedin_url",
    "match_strategy": "linkedin_url",
    "duplicate_mode": "upsert",
    "merge_mode": "fill_empty"
  }

Response example

json

{
    "ok": true,
    "match_rule_id": "linkedin_url",
    "match_strategy": "linkedin_url",
    "duplicate_mode": "upsert",
    "merge_mode": "fill_empty"
  }