Skip to main content
Talk to salesStart

Import a connected CRM list

Import a provider list into a new or existing Research Table.

POST/api/crm/{provider}/lists/{list_id}/import
HTTP referenceScope integrations:read AND integrations:write AND tables:writeUpdated September 27, 2026

This page documents the canonical HTTP contract for this endpoint.

Developer keys are supported only for concrete HubSpot, Attio, or Salesforce routes and require all three scopes. Other provider names are not admitted by the key scope resolver. The JSON receipt is the connected-import command result.

Path parameters

  • providerrequired

    string

    hubspot, attio, or salesforce.

  • list_idrequired

    string

Body parameters

  • table_id · optional

    string

    Required when table_mode is append.

  • table_mode · optional

    string

    create or append; defaults create.

  • import_type · optional

    string

  • selected_fields · optional

    array<string>

  • filters · optional

    array<object>

  • table_name · optional

    string

Errors

StatusMeaning
400Unsupported provider, invalid body, or append mode missing table_id.
401Missing or invalid authentication or organization context.
403One or more of integrations:read, integrations:write, or tables:write are missing.
409Provider is not connected or requires reauthorization.

Docs