Skip to main content
POST
Import Contacts

Authorizations

Authorization
string
header
required

Your API key. Send in the Authorization header as: Bearer

Body

application/json
folder_id
string
required

Folder ID to import contacts into

file_key
string | null

Storage key for uploaded CSV file (legacy)

contacts
ContactCreate · object[] | null

Direct contact data array (legacy)

csv_base64
string | null

Base64 encoded CSV file content

base64_file
string | null

Base64 encoded CSV file content (legacy alias for csv_base64)

filename
string | null

Original filename of the CSV

mapping_config
Mapping Config · object | null

Mapping from CSV headers to standard fields. Format: {'csv_header': 'standard_field'}. Unmapped fields go to metadata.

Response

Successful Response

data
ContactImportResponse · object
required
meta
ResponseMeta · object
required

Metadata included in every API response.