Update contact

PATCH

/users/me/contacts/{id}

Partial update of a single contact's fields: name, email, company, avatar, tags, isFavorite, lifecycleStage, doNotCall, doNotSms. Changing phoneNumber resets the contact's identity key — avoid unless intentional. doNotCall and doNotSms act as outbound suppression flags; enforcement happens at send time, not in this endpoint.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

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

{
    "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,
    "id": "string",
    "stats": {
        "totalIncomingCalls": 0,
        "totalOutboundCalls": 0,
        "totalSmsMessages": 0,
        "lastCallDate": "string",
        "upcomingAppointments": 0
    },
    "latestNote": {
        "content": "string",
        "createdAt": "string"
    },
    "suggestedLifecycleStage": "string"
}

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

Get all contacts

Get a single contact with stats