Update a contact by ID

patch

https://platform.textingline.com/api/v1/contacts/{contactId}

Updates the contact with the given ID — the same JSON Merge Patch semantics, validation and errors as PATCH /contacts/by-phone/{phoneNumber}.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

contactId

string

required

Contact ID (con_...), as returned in id. The same contact is also addressable by phone: /contacts/by-phone/{phoneNumber}.

Body Params

firstName

object | null

Contact's first name.

lastName

object | null

Contact's last name.

object | null

Contact's email address.

birthDate

object | null

Date of birth, strict YYYY-MM-DD format. Full ISO datetimes are rejected.

gender

string | null

enum

Contact's gender.

Allowed:

address

object | null

Contact's mailing address. Per-sub-field merge: only sub-fields present in the payload are touched. Send address: null to clear the entire embed; send a sub-field with null to clear that sub-field only.

isFavorite

boolean

Whether the contact is flagged as favorite by the operator.

customFields

object | null

Custom-field values keyed by label (the human-readable name you gave the field). Labels are matched case-insensitively after trimming whitespace. Per-label merge: only labels present in the payload are touched. Send customFields: null to clear all values; send an individual label with null to clear that value; send "" to clear TEXT values; send [] to clear MULTI_SELECT values. Discover labels, types, and select options via GET /v1/contacts/custom-fields/schema. Value shape per schema field type: TEXT → string, NUMBER → number, BOOLEAN → boolean, DATE → YYYY-MM-DD string, SINGLE_SELECT → string matching one of options, MULTI_SELECT → array of strings each matching one of options. Unknown labels are rejected with 33033 InvalidCustomField and details.reason: "unknown_label".

Responses

200Contact updated.

40033034 Invalid ID — not a con_... contact ID. 33033 Invalid custom field. 33024 Request validation failed (e.g. an unknown body property).

40433030 Contact not found — no contact with this ID on your account.