Import contacts from CSV or JSON file

POST

/users/me/contacts/import

Bulk import from arbitrary CSV or JSON. An AI pass reads the first 10 lines / 500 chars and auto-maps unknown column names to canonical contact fields (firstName, lastName, phoneNumber, email, address, companyName, notes, tags). If mapping fails, sensible defaults are used. Rows missing a valid phone, or missing BOTH firstName and companyName, are rejected with per-row errors; valid rows merge by phone rather than creating duplicates. Comma-separated tag strings are split into arrays.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Contacts imported successfully

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location '/users/me/contacts/import' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "format": "csv",
    "content": "string"
}'

Response Example

{
    "success": true,
    "imported": 0,
    "errors": [
        "string"
    ],
    "contacts": [
        {
            "firstName": "string",
            "lastName": "string",
            "phoneNumber": "string",
            "email": "string",
            "address": "string",
            "notes": "string",
            "companyName": "string",
            "tags": [
                "string"
            ],
            "avatar": "string",
            "isFavorite": true,
            "source": "MOBILE",
            "lifecycleStage": "lead",
            "doNotCall": true,
            "doNotSms": true
        }
    ]
}

Modified at 2026-07-23 18:02:16

Search contacts

Get tag statistics for autocomplete