LUlusha
Contacts Tables

Add Columns to Contacts Table

Changed on

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.

post/v3/contacts/tables/{table_id}/columns

Request

Path parameters

table_idstring required

The table's ID.

Request body

OR

Example request

{
  "columns": [
    {
      "columnKey": "jobTitle"
    }
  ],
  "columnKey": "jobTitle",
  "owner": {
    "email": "user@example.com"
  }
}

Response

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

Example response

{
  "data": [
    {
      "columnKey": "jobTitle",
      "columnId": "c_9f2a1b",
      "status": "added",
      "error": {
        "code": "COLUMN_ALREADY_EXISTS",
        "message": "Column already exists on this table"
      }
    }
  ],
  "billing": {
    "creditsCharged": 3,
    "resultsReturned": 1
  }
}

Changes