Start Import

curl --request POST \ --url https://app.rizzdial.com/api/contacts/import/start \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "headers": [ "Phone" ], "mapping": { "Phone": "phone_number" }, "filename": "leads.csv", "powerlist": { "existing_id": 1 }, "total_rows": 2, "tcpa_consent": true, "duplicate_strategy": "update" }'

Start Import#

Opens an import session. tcpa_consent must be true, and one mapped column must be phone_number. Send either powerlist.existing_id or powerlist.name.

Authorizationstringheaderrequired

Bearer token in the format: Bearer {access_token}

total_rowsintegerbodyrequired

Number of data rows

mappingobjectbodyrequired

Header to contact field. May be empty; the server fills blanks

headersstring[]body

CSV headers

tcpa_consentbooleanbodyrequired

Must be true

powerlistobjectbodyrequired

existing_id or a new name. Optional dial_mode is ai or manual

duplicate_strategystringbody

skip, update, or create

tag_idsinteger[]body

Existing contact tag ids

curl --request POST \
  --url https://app.rizzdial.com/api/contacts/import/start \
  --header 'Authorization: Bearer {{bearer_token}}' \
  --header 'Content-Type: application/json' \
  --data '{
  "filename": "leads.csv",
  "total_rows": 2,
  "mapping": {
    "Phone": "phone_number"
  },
  "headers": [
    "Phone"
  ],
  "tcpa_consent": true,
  "powerlist": {
    "existing_id": 1
  },
  "duplicate_strategy": "update"
}'

import_idinteger

Session id used by chunk, finish, status, and cancel

powerlist_idinteger

Powerlist that will receive the rows

mappingobject

The mapping the server will use