Sign in

v1

latestOpenAPI 3.0.3Proprietary2026-08-0656136286.9 KB
Contacts Tables

Add Entities to Contacts Table

Add up to 500 contact IDs to an existing table. entityIds accepts either the encrypted Lusha token (v{N}.…, as returned by Search/Enrich/Get Entities) or the legacy numeric personId — an ID that's neither returns 400. Already-present IDs are reported as alreadyPresent and not re-added; unresolvable IDs are not an error, they come back in invalidIds with a 200.

Optionally pass companyIds — one lushaCompanyId per contact, index-aligned with entityIds — to help pair company-level enrichment to the right company for each contact.

Billing: Free.

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

Path parameters

table_idstring required

The table's ID.

Request body

entityIdsstring[] required

Lusha IDs as strings — personId for contacts, lushaCompanyId for companies. Accepts either the encrypted token (v{N}.…, as returned by Search/Enrich/Get Entities) or the legacy numeric ID. An ID that is neither a valid token nor numeric returns 400.

companyIdsstring[]

Contacts tables only. One lushaCompanyId per contact (encrypted token or numeric), index-aligned with entityIds, to help pair company-level enrichment to the right company for each contact. Ignored on companies tables.

Example request

{
  "entityIds": [
    "10042854",
    "10042855",
    "10042856"
  ],
  "companyIds": [
    "16303253",
    "16303253",
    "12790225"
  ],
  "owner": {
    "email": "user@example.com"
  }
}

Response

Entities added

Example response

{
  "data": {
    "added": 20,
    "alreadyPresent": 5,
    "invalidIds": [],
    "addedBy": {
      "surface": "api"
    }
  },
  "billing": {
    "creditsCharged": 3,
    "resultsReturned": 1
  }
}