Skip to main content
POST

Authorizations

api_key
string
header
required

Your Lusha API key. You can find this in your Lusha dashboard under API settings. Include this key in the api_key header for all requests.

Path Parameters

table_id
string
required

The table's ID.

Body

application/json

Supply either columns (up to 10 entries) or a single columnKey - not both. Sending neither returns 400.

columns
object[]
required

Up to 10 Lusha columns to add in one call.

Required array length: 1 - 10 elements
columnKey
string

Shorthand for adding exactly one column.

Example:

"jobTitle"

owner
object

Identifies the user acting on the table, and resolves to a user on your account. Required on every table-route call when authenticating with an API key (there is no signed-in user) - omitting it returns 400. Optional for OAuth/token callers, since the caller is already identified by the token; still accepted if you want to act on behalf of another owner.

Response

Columns processed. Returns one entry per requested column - check each entry's status, as some may have failed while others succeeded.

One entry per requested column. Enrichment runs asynchronously on every row in the table for each successfully added column - poll Get Table for isProcessing and per-column row-status counts, then read the values via Get Table Entities.

data
object[]
billing
object

Credit usage summary for a V3 API request