Bulk Import Contacts

Import contacts in bulk via JSON array or CSV file upload. Processing happens asynchronously - returns an upload ID for tracking.

JSON Body:

{
  "contacts": [
    { "email": "john@example.com", "first_name": "John" },
    { "email": "jane@example.com", "first_name": "Jane" }
  ],
  "TeamId": "uuid",
  "CampaignId": "uuid"
}

CSV Upload: Use multipart/form-data with:

• contacts: CSV file
• TeamId: Team UUID
• CampaignId: Campaign UUID
• mapping_fields: JSON mapping of CSV columns to contact fields
• validate_emails: Optional. Set to true to run email verification (consumes credits). Default false.

Email Validation: Set validate_emails: true to queue verification for contacts in the import (consumes credits). Default is false to avoid surprise billing. Applies to both JSON and CSV uploads. For single-contact upsert (POST /contacts), already-validated profiles are not re-checked.

Limits:

• Maximum 50,000 contacts per request
• Subject to your organization's contact limit