Update contact

If you have questions regarding this API, please visit our API FAQ page.

Updating a contact

Make a PATCH request to https://webapi.inboxroad.com/api/v2/contacts-lists/{blueprint_id}/contacts/{contact_id}/ with a valid X-API-Key. Only the keys present in the body are modified.

curl -X PATCH 'https://webapi.inboxroad.com/api/v2/contacts-lists/{blueprint_id}/contacts/{contact_id}/' \
  -H 'X-API-Key: <your_token>' \
  -H 'Content-Type: application/json' \
  -d '{
    "first_name": "Jonathan",
    "status": "unsubscribed"
  }'

Path parameters

Param name	Description
blueprint_id	Unique identifier of the contacts list (UUID).
contact_id	Unique identifier of the contact (integer).

Request fields

The always-present default fields (all optional on update):

Field name	Description
email	New email address. Max 150 chars.
first_name	New first name. Max 50 chars.
last_name	New last name. Max 50 chars.
status	New subscription state (subscribed / unsubscribed).

Custom fields

You may also update any custom fields defined on the list; extra keys are validated against the list’s field schema. See Get contact list to discover the available fields. Only the fields you include are changed — omitted fields are left untouched.

Example request

{
  "first_name": "Jonathan",
  "status": "unsubscribed"
}

Response

Returns 200 with the updated contact record (defaults plus any custom fields).

{
  "id": 4821,
  "email": "john.doe@example.com",
  "first_name": "Jonathan",
  "last_name": "Doe",
  "status": "unsubscribed",
  "created_at": "2026-05-21T09:45:00Z",
  "plan": "pro"
}

Possible response codes

Status code	Description
200	Contact updated successfully.
400	Invalid request data, or a contact with this email already exists. Body: { "errors": [ ... ] }.
401	Unauthorized.
403	Updating contacts is not available for your account. Body: { "errors": [ ... ] }.
404	Contact not found.