contacts

Update a contact

Changed on

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}

Request

  • Base URL
    https://public-api.ringover.com/v2
  • URL
    https://public-api.ringover.com/v2/contacts/{contactId}
  • Auth
    API key in header Authorization

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"
    }
  ]
}

Changes