Skip to main content
POST
/
contacts
/
import
Import Contacts (CSV)
curl --request POST \
  --url https://api.truedy.ai/api/public/v1/contacts/import \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form folder_id=folder_abc123 \
  --form overwrite_existing=false \
  --form file='@example-file'
{
  "data": {
    "imported": 142,
    "updated": 8,
    "skipped": 3,
    "errors": 1,
    "folder_id": "folder_abc123",
    "error_details": [
      {
        "row": 5,
        "phone": "+1invalid",
        "reason": "Invalid phone number format"
      }
    ]
  },
  "meta": {
    "request_id": "req_32e7531c",
    "ts": "2026-04-05T10:22:00Z"
  }
}

Authorizations

​
Authorization
string
header
required

API key authentication. Include your API key in the Authorization header: Bearer <your_api_key>

Body

multipart/form-data
​
file
file
required

CSV file. Required column: phone. Optional: name, email, custom fields.

​
folder_id
string | null

Target folder ID. Contacts go to the default folder if omitted.

Example:

"folder_abc123"

​
overwrite_existing
boolean
default:false

Update existing contacts matched by phone number.

Response

Import completed