v1

latestOpenAPI 3.0.3Proprietary2026-08-0656136286.9 KB

Companies Tables

Create Companies Table

Create a new, empty companies table, optionally seeded with an initial list of company IDs.

Billing: Free.

post/v3/companies/tables

Request body

namestring required

visibility'private' | 'shared'

idsstring[]

Optional initial entity IDs to seed the table with.

Example request

{
  "name": "postman-companies",
  "owner": {
    "email": "user@example.com"
  },
  "ids": [
    "10042851",
    "10042852"
  ]
}

Response

Table created

Example response

{
  "data": {
    "tableId": "482910",
    "name": "VP Sales US Tech Q2",
    "entityType": "contacts",
    "visibility": "private",
    "status": "active",
    "owner": {
      "id": 12345,
      "email": "owner@lusha.com",
      "name": "Ada Lovelace"
    },
    "createdBy": {
      "surface": "api",
      "createdByUserId": 12345
    },
    "workspaceUrl": "https://workspace.lusha.com/tables/482910",
    "entityCount": 5,
    "columns": [
      {
        "columnId": "c1",
        "name": "Job title",
        "type": "lusha",
        "key": "jobTitle"
      }
    ]
  },
  "billing": {
    "creditsCharged": 3,
    "resultsReturned": 1
  }
}