Skip to main content
Talk to salesStart

Create research table from leads

Freeze a Leads selection and queue a standardized research table.

POST/api/leads/create-research-table
HTTP referenceScope leads:read AND leads:write AND companies:read AND tables:read AND tables:writeUpdated September 27, 2026

This page documents the canonical HTTP contract for this endpoint.

Provide exactly one destination. The compatibility field fields is accepted by the request model but any non-empty value is rejected. The handler queues a durable materialization and returns its JSON receipt.

Body parameters

  • selectionrequired

    object

    BulkLeadsSelectionRequest; lead_ids or supported selection criteria.

  • tableName · optional

    string

    Supply exactly one of tableName or destination_table_id.

  • destination_table_id · optional

    string

  • fields · optional

    array<string>

    Non-empty values are rejected; table columns use the standard Lead/Company schema.

  • research_field_ids · optional

    array<string>

  • allow_mixed_grain · optional

    boolean

  • find_emails · optional

    boolean

  • find_mobile · optional

    boolean

  • expected_matched_count · optional

    integer

    1–5,000 when provided.

Errors

StatusMeaning
401Missing or invalid authentication.
403All five scopes are required.
422Provide exactly one destination; non-empty fields are no longer supported.

Docs