Skip to main content
Talk to salesStart

Create research table from companies

Freeze a Companies selection and queue table materialization.

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

This page documents the canonical HTTP contract for this endpoint.

Send exactly one table destination (tableName or destination_table_id). The optional Idempotency-Key header is accepted by the route. Result is the durable table-materialization admission object.

Body parameters

  • selectionrequired

    object

    Companies BulkSelectionModel; explicit ids or supported native selection fields.

  • tableName · optional

    string

    Supply exactly one of tableName or destination_table_id.

  • destination_table_id · optional

    string

  • allow_mixed_grain · optional

    boolean

    Defaults false.

  • expected_matched_count · optional

    integer

    1–5,000 when provided.

Errors

StatusMeaning
401Missing or invalid authentication.
403All four scopes are required.
422Provide exactly one destination; expected_matched_count must be between 1 and 5,000.

Docs