Add Columns to Contacts Table
Add up to 10 Lusha columns to a table in one call. Enrichment starts automatically on all rows in the table as soon as the columns are added.
Body - either a list or a single key:
columns: [{ "columnKey": "jobTitle" }, { "columnKey": "seniority" }]columnKey: "jobTitle"for a single column
Keys come straight from Get Contacts Column Catalog.
Partial success: columns are handled independently. The response returns one entry
per requested column with its own status (added / failed) and columnId - if one
column fails the rest still go through. The most common failure is the column already
being on the table, in which case the existing columnId is returned, so the call is
safe to re-run.
Billing: Free today - credits aren’t charged for adding columns yet.
curl --request POST \
--url https://api.lusha.com/v3/contacts/tables/{table_id}/columns \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"columns": [
{
"columnKey": "jobTitle"
},
{
"columnKey": "seniority"
},
{
"columnKey": "workEmail"
}
],
"owner": {
"email": "user@example.com"
}
}
'{
"data": {
"columns": [
{
"status": "added",
"columnId": "d674a3ee-5c1b-4f2a-9e3d-8b7a6c5d4e3f",
"name": "First name",
"runStatus": "processing"
}
],
"added": 1,
"failed": 0
},
"billing": {
"creditsCharged": 0,
"lowBalance": false
}
}Authorizations
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
The table's ID.
Body
- Option 1
- Option 2
Supply either columns (up to 10 entries) or a single columnKey - not both. Sending neither returns 400.
Up to 10 Lusha columns to add in one call.
1 - 10 elementsShow child attributes
Show child attributes
Shorthand for adding exactly one column.
"jobTitle"
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.
Show child attributes
Show child attributes
Response
Columns processed. Returns one entry per requested column - check each entry's status, as some may have failed while others succeeded.
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.
Was this page helpful?
curl --request POST \
--url https://api.lusha.com/v3/contacts/tables/{table_id}/columns \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"columns": [
{
"columnKey": "jobTitle"
},
{
"columnKey": "seniority"
},
{
"columnKey": "workEmail"
}
],
"owner": {
"email": "user@example.com"
}
}
'{
"data": {
"columns": [
{
"status": "added",
"columnId": "d674a3ee-5c1b-4f2a-9e3d-8b7a6c5d4e3f",
"name": "First name",
"runStatus": "processing"
}
],
"added": 1,
"failed": 0
},
"billing": {
"creditsCharged": 0,
"lowBalance": false
}
}