Update Contact

Update an existing contact in your address book. This endpoint allows you to modify contact details such as the phone number or associated metadata.

POST /addressbook/contacts/{msisdn}

Replace {msisdn} with the phone number of the contact you want to update.

Required Permission

update:Contacts

Your API key must have this permission enabled in order to use this endpoint.

Example Request

curl --location 'https://<hostname>/addressbook/contacts/55555555555' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --data '{
    "msisdn": "55555555555",
    "alias": "john",
    "meta": {
      "NAME": "John Doe"
    }
  }'

Replace YOUR_API_KEY with your API key.

All endpoints shown in this documentation use a sample base URL. The production API endpoint is provided by our team upon request.

Request Parameters

Path Parameters

Field	Type	Required	Description
msisdn	string	Yes	Phone number of the contact to update.

Body Parameters

Field	Type	Required	Description
msisdn	string	No	Updated phone number in international format.
alias	string	No	Updated alias for the contact.
meta	object	No	Updated metadata associated with the contact.

Responses

Success (HTTP 200)

Returned when the contact is successfully updated.

{
  "success": true,
  "record": {
    "id": "3392287d-7a79-4789-9ef8-7dc174836688",
    "alias": "john",
    "msisdn": "55555555555",
    "updated_on": "2025-11-10T20:45:30.000Z"
  }
}

Validation Error (HTTP 400)

Returned when the specified contact does not exist.

{
  "success": false,
  "error": {
    "name": "NotFoundError",
    "statusCode": 404,
    "message": "Contact not found"
  }
}

Updating a contact does not affect historical message records.