BetaThe v2 API is in beta — fields and behavior may change without notice. For stable production usage, see the API v1 Reference.

Contacts

Update a contact

Partial update — send only the fields you want to change. Custom attributes are merged, not replaced.

Endpoint

text
PATCH https://services.chatmount.co/v2/chatbots/:chatbotId/contacts/:contactId

Request body

json
{
  "data": {
    "name": "John Doe",
    "email": "john@example.com",
    "phonenumber": "+1234567890",
    "custom_attributes": {
      "department": "Engineering",
      "subscription_tier": "Enterprise"
    }
  }
}

Patchable: external_id, name, email, phonenumber, stripe_accounts, custom_attributes.

Response

json
{
  "message": "Success",
  "data": {
    "id": "contact_internal_123",
    "external_id": "user_123",
    "name": "John Doe",
    "email": "john@example.com",
    "custom_attributes": { "...": "..." },
    "created_at": 1704067200,
    "updated_at": 1704153600
  }
}

Errors: 409 when the new external_id or email already belongs to another contact.

Related