Skip to main content
GET
Suggest a column mapping for a table

Authorizations

X-API-Key
string
header
required

Query Parameters

table_id
string<uuid>
required

Response

Successful Response

Which audience columns carry a meaning, all detected from the table.

One field per channel (email, LinkedIn) plus the company domain the coverage line reports on. Leave the whole object out when binding an audience and the columns are detected server-side. Send it only to correct a detection: a first name, a company or a last-contacted date is no longer part of this, because every column on the table is already addressable as a {{Column name}} variable.

company_domain_column_id
string<uuid> | null

The account identity, reported on by the audience coverage counts. Unmapped, the coverage count is zero.

email_column_id
string<uuid> | null

Where the send address is read from, and the deduplication key: two rows sharing an address are one contact.

email_deliverability_column_id
string<uuid> | null

The column holding each address's deliverability verdict, usually the Verify email column over the email column; detected when the table has one. Read only while an email column is mapped, and dropped without one. An address is emailed only when its verdict is one of email_deliverability_results; any other verdict skips the email step (LinkedIn steps still run), and an address not verified yet waits for its verdict. Unmapped, every address is emailed unverified.

email_deliverability_results
enum<string>[]

The verdicts the sequence emails: valid, catch-all, risky, unknown, invalid or disposable. Valid alone by default; an empty list reads as the default. An answer the column could not give counts as unknown.

Maximum array length: 6

The verdicts a Verify email column answers with, in the words its cells hold.

The verify_email chain respells every supplier's verdict onto exactly these words (email_verdict_canonical in table_enrichments), so a sequence that reads the column compares its cells against them. Ordered from the safest to send to, which is the order the Audience tab lists them.

Available options:
valid,
catch-all,
risky,
unknown,
invalid,
disposable
linkedin_url_column_id
string<uuid> | null

Required by LinkedIn steps; a row without one skips them.