{"templateId":"markdown","sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Tables API","description":"Access documentation, use cases, and technical guides for Lusha. Learn how to query our comprehensive dataset of business profiles and company information using our three main endpoints.","siteUrl":"https://docs.lusha.com","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"tables-api","__idx":0},"children":["Tables API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Learn how to create, manage, and automate Workspace tables using the Lusha REST API."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-is-tables-api","__idx":1},"children":["What is Tables API?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Tables API lets you create and manage Workspace tables programmatically - the same tables you build manually in the Workspace UI, now automatable via REST API."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can create tables, add contacts or companies, enrich records, run signals, and read results - all without opening the UI. Every change made via the API reflects in your Workspace in real time, and vice versa. Tables are a single source of truth across both surfaces."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Available for:"]}," Scale and Enterprise plans (full access). Pro plan (read only). Not available on Free."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"why-use-it","__idx":2},"children":["Why use it?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Until now, data retrieved via the Lusha API had nowhere to land inside Lusha - it went to a spreadsheet, a CRM, or disappeared at the end of a session. The Tables API closes that gap."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Developers can persist search and enrichment results directly inside Lusha"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["RevOps teams can automate weekly list rebuilds without manual work"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Automation platform users (Zapier, Make, n8n) get a native Lusha destination"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["MCP users can manage tables through Claude in natural language - no code needed"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-you-can-do-today","__idx":3},"children":["What you can do today"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Tables API covers three groups of endpoints, symmetric for contacts and companies (replace ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/contacts/"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/companies/"]}," for company tables):"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Group"},"children":["Group"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Endpoint"},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What it does"},"children":["What it does"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tables"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v3/contacts/tables/create"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create a new table"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tables"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v3/contacts/tables/list"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List all tables you own or that are shared with your account"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tables"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v3/contacts/tables/status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Get a table's metadata and processing state"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tables"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v3/contacts/tables/update"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Update name, description, visibility, or archive state"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tables"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v3/contacts/tables/delete"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Permanently delete a table"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Entities"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v3/contacts/tables/entities/add"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Add up to 500 entity IDs"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Entities"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v3/contacts/tables/entities/remove"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Remove entity IDs from a table (up to 500 per call)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Entities"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v3/contacts/tables/entities/get"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read entities with full column data and per-cell status (charges per row)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Columns"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v3/contacts/tables/columns/list"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List columns on a table"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Columns"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v3/contacts/tables/columns/run"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Run a column on all, missing, or specific rows"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Columns"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v3/contacts/tables/columns/remove"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Remove a column and its data"]}]}]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["💡 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," All endpoints use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["api_key"]}," header for authentication. When authenticating with an API key, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["owner.email"]}," is required in every request body - omitting it returns a 400 error. Symmetric endpoints exist for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v3/companies/tables/*"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"tableid-on-existing-v3-endpoints","__idx":4},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tableId="]}," on existing V3 endpoints"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tableId="]}," on four existing V3 endpoints to search or enrich and persist results to a table in one call:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"V3 endpoint"},"children":["V3 endpoint"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What tableId= adds"},"children":["What ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tableId="]}," adds"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v3/contacts/prospecting"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Search and save results to a table"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v3/contacts/lookalike"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Find lookalike contacts and save to a table"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v3/contacts/enrich"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reveal email/phone and populate the relevant columns"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v3/contacts/signals"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fetch signals and populate the Signals column"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["opt-in. If you don't pass ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tableId="]},", these endpoints behave exactly as today. No breaking changes."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"adding-columns---coming-soon","__idx":5},"children":["Adding columns - coming soon"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can list, run, and remove columns via the API today. However, adding new columns programmatically (for example, adding a Signals column or an AI insights column) is not yet available via API."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["💡 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," To add columns now, open your table in the Workspace UI and add them manually. Once added there, you can run and manage those columns via the API."]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["⚠️ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Heads up:"]}," The API reference at docs.lusha.com currently lists a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["columns/add"]}," endpoint. This endpoint is not yet active. We'll update this article as soon as it's available."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Adding columns via API is coming soon. We'll update this article when it's available."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"plan-availability","__idx":6},"children":["Plan availability"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Plan"},"children":["Plan"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tables Access"},"children":["Tables Access"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Column Ops"},"children":["Column Ops"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Read Entities"},"children":["Read Entities"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Free"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not available"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pro"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read only"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Scale"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Full access"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Full access*"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Enterprise"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Full access"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Full access*"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["* Column operations include: list, run, and remove. Adding columns via API is Phase 2."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-to-get-started","__idx":7},"children":["How to get started"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Here's the full flow from creating a table to reading enriched results:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create a table"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v3/contacts/tables/create"]}," with a name and optional description. The response returns a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tableId"]}," and a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["workspaceUrl"]}," you can open directly in Workspace."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add contacts or search and save in one call"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v3/contacts/tables/entities/add"]}," to add up to 500 Lusha contact IDs per call. Or search and add in one step by passing ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tableId="]}," on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v3/contacts/prospecting"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add columns in the Workspace UI"]}," ","Open your table in Workspace and add the columns you need - Signals, enrichment fields, AI insights, custom fields. Once created, you can run and manage them via the API."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Run a column"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v3/contacts/tables/columns/run"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["scope: \"all\""]}," to populate data for all rows, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"missing\""]}," for rows not yet processed, or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"specific\""]}," with a list of entity IDs."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Poll for completion"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v3/contacts/tables/status"]}," until ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isProcessing"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]},". The response also tells you which columns are still running."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Read the table"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v3/contacts/tables/entities/get"]}," to retrieve all rows with full column data and per-cell status. Note: reading entities charges per row returned."]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["💡 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," Every table response includes a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["workspaceUrl"]},". Click it to open the table directly in Workspace - the same data, the same table, both surfaces in sync."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"via-mcp-claude","__idx":8},"children":["Via MCP (Claude)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you're using Lusha via MCP in Claude, you can manage tables through natural language - no API knowledge required."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Tell Claude what you need (for example: \"find VP Sales in US tech and save them to a table\") and it handles the API calls. The table appears in your Workspace automatically."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each REST endpoint maps to an atomic MCP tool: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["table_create"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["table_search_and_save"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["table_enrich"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["table_signals"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["table_run_column"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["table_status"]},", and more."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["💡 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," MCP capabilities for Tables are rolling out shortly. Check the Lusha MCP connector in Claude for availability."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"credit-model","__idx":9},"children":["Credit model"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Credits are charged based on what data is revealed or processed:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Free: Table CRUD, listing columns, adding/removing entities (contacts tables)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Reading entities: charges per row returned"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Adding companies to a table: charges ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reveal_company"]}," per newly added company (deduped - already-present companies aren't charged again)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Contact reveal: 1 credit per email, 5 credits per phone - charged once per account"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Company enrichment column: charged once per company per table; re-runs on an already-paid company are free"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Signals, AI columns, premium data points: charged per row, per run (re-running charges again)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Adding a column: free; if ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["runScope"]}," triggers an immediate run, that run is billed as a normal column run"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every API response includes a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["billing"]}," field that shows exactly how many credits were charged and for which rows."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"account-limits","__idx":10},"children":["Account limits"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Up to 500 entity IDs per add or remove call"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Up to 50,000 entities per table"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Up to 500 tables per account"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"common-error-codes","__idx":11},"children":["Common error codes"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Code"},"children":["Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Meaning"},"children":["Meaning"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TABLE_NOT_FOUND"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tableId"]}," doesn't exist or you don't have access"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TABLE_NAME_CONFLICT"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A table with that name already exists on your account"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BATCH_LIMIT_EXCEEDED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["More than 500 IDs in a single ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["entities/add"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["entities/remove"]}," call"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FORBIDDEN"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your plan doesn't include this operation"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RATE_LIMIT_EXCEEDED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Slow down and retry"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You're all set! Your tables are ready to automate. 🎉"]}]},"headings":[{"value":"Tables API","id":"tables-api","depth":1},{"value":"What is Tables API?","id":"what-is-tables-api","depth":2},{"value":"Why use it?","id":"why-use-it","depth":2},{"value":"What you can do today","id":"what-you-can-do-today","depth":2},{"value":"tableId= on existing V3 endpoints","id":"tableid-on-existing-v3-endpoints","depth":2},{"value":"Adding columns - coming soon","id":"adding-columns---coming-soon","depth":2},{"value":"Plan availability","id":"plan-availability","depth":2},{"value":"How to get started","id":"how-to-get-started","depth":2},{"value":"Via MCP (Claude)","id":"via-mcp-claude","depth":2},{"value":"Credit model","id":"credit-model","depth":2},{"value":"Account limits","id":"account-limits","depth":2},{"value":"Common error codes","id":"common-error-codes","depth":2}],"frontmatter":{"seo":{"title":"Tables API"}},"lastModified":"2026-07-28T13:20:52.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/tutorials/tables","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}