Sync contacts from mobile device

POST

/users/me/contacts/sync

Bulk upsert of contacts from the device address book, keyed on userId + phoneNumber. Existing contacts are updated with the most recent values, new ones are created. Rows missing phoneNumber or missing BOTH firstName AND companyName are silently skipped and counted. Phone numbers are normalized (strips (), -, spaces) so formatting variations don't create duplicates. Does NOT emit timeline activity — this is a silent sync.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Contacts synced successfully

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location '/users/me/contacts/sync' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "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
        }
    ]
}'

Response Example

{
    "success": true,
    "message": "string"
}

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

Get current user profile

Delete all contacts