Building a webhook integration? Read the webhook guide for signatures, retries, event schemas, and troubleshooting.

apiDeterministic

Create table from search

POST /api/leads/create-table

Run a LinkedIn search and materialize results into one explicit destination. Pass targetTableId to append net-new rows to an existing table, or createNewTable: true to intentionally create a table. Sequential company appends deduplicate by company LinkedIn URL or domain; people appends use personal LinkedIn URL. Requires a connected LinkedIn account.

Parameters

workspaceId

string

Workspace UUID (optional with API key auth - inferred from the key).

accountIdrequired

string

LinkedIn account ID to run the search through.

searchTyperequired

string

No description.

people | companies

searchParamsrequired

object

LinkedIn search parameters (keywords, title, location, industry, etc.).

targetTableId

string

Existing table to append into. Mutually exclusive with createNewTable.

createNewTable

boolean

Explicitly create a new table. Mutually exclusive with targetTableId.

true

tableName

string

Optional. Auto-generated from search params when omitted.

workbookId

string

Optional workbook to add the table to.

resultLimit

number

Max results to fetch.

enrichmentOptions

object

Opt-in enrichment columns (companyEnrichment, icpScoring, messaging).

Example

REST requestbash

curl -X POST "https://app.pipeline.help/api/leads/create-table" \
  -H "Authorization: Bearer $PIPELINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"accountId":"00000000-0000-4000-8000-000000000000","searchType":"people","searchParams":{},"createNewTable":true}'

Response

The operation is available, but its typed response schema has not been published yet.

HTTP errors

401: Missing or invalid API key.
403: Authenticated but not permitted for the workspace or resource.
404: The requested resource was not found.