latestOpenAPI 3.1.1Proprietary – Contact us for usage terms2026-08-20173183551.4 KB

9da73dd2f99e

contacts

Update a contact

Update a contact by its ID. All fields are mandatory except the numbers array. If the numbers array is provided, existing numbers will be replaced by the ones in the request body. If omitted, numbers are left unchanged.

Permission: Contacts Write required.

Monitoring impact: None — contacts are always scoped to your own address book.

put/contacts/{contactId}

Path parameters

contactIdinteger required
Example:123456

The identifier of the contact

Request body

firstnamestring
lastnamestring
companystring
is_sharedboolean

Example request

{
  "firstname": "John",
  "lastname": "Doe",
  "company": "DoeCompany",
  "numbers": [
    {
      "number": 33184800000,
      "type": "mobile"
    }
  ]
}

Response

Successful operation — the updated contact is returned.

firstnamestring
lastnamestring
companystring
is_sharedboolean

Example response

{
  "firstname": "John",
  "lastname": "Doe",
  "company": "DoeCompany",
  "numbers": [
    {
      "number": 33184800000,
      "type": "mobile"
    }
  ]
}