v1

latestOpenAPI 3.0.3Proprietary2026-08-0656136286.9 KB

Companies Tables

Add Entities to Companies Table

Add up to 500 company 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 lushaCompanyId — 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.

Billing: Charges reveal_company per newly-added company, deduped via row-count delta — duplicates and already-present companies aren't charged again.

post/v3/companies/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
  }
}