REretellai

POST /create-contact-import

Changed on

Start an incremental contact import from an uploaded CSV: creates new contacts and updates existing ones matched by phone number. Mapped columns overwrite the matched contact's fields; unmapped columns are ignored. Runs asynchronously — poll get-contact-import for progress.

Request

  • Base URL
    https://api.retellai.com
  • Auth
    HTTP bearer

Request body

upload_idstring required

Id returned by upload-contact-import-file.

default_countrystring

Country for parsing phone numbers without a country code. Defaults to US.

contact_tagsstring[]

Tag labels added to every contact in this import. Labels are trimmed and deduplicated. New labels are added to the org's CRM config with generated tag IDs.

Response

Import queued.

status'queued' | 'running' | 'idle' required
start_timestampnumber

Epoch milliseconds when the job started.

succeedednumber

Number of items processed successfully so far.

failednumber

Number of items that errored so far.

triggered_by'manual' | 'cron'

Whether the job was started by an explicit API call (manual) or by the scheduled sync (cron).

Changes