Skip to main content
Talk to salesStart

Import CRM records

Import selected provider record identifiers through the canonical CRM import pipeline.

POST/api/crm/{provider}/import-records
HTTP referenceScope integrations:read AND leads:write AND companies:writeUpdated September 27, 2026

This page documents the canonical HTTP contract for this endpoint.

Developer keys are supported only for HubSpot, Attio, and Salesforce concrete routes. The selected provider record references are imported server-side; remote field payloads are not accepted in this request.

Path parameters

  • providerrequired

    string

    hubspot, attio, or salesforce.

Body parameters

  • object_type · optional

    string

    Defaults contact.

  • record_idsrequired

    array<string>

    1 through 500; blank IDs are rejected and duplicates removed.

  • connection_id · optional

    string

  • provider_account_id · optional

    string

Errors

StatusMeaning
400Request body required or invalid.
401Missing or invalid authentication or organization context.
403One or more of integrations:read, leads:write, or companies:write are missing.
409Provider connection is unavailable or requires reauthorization.
422record_ids must contain 1–500 non-empty IDs.

Docs