Update a contact (partial)

Updates any subset of firstName, lastName, email, phone, title, notes. If the patch would make this contact's canonical identity match another existing contact on the same merchant, returns HTTP 409 Conflict (we do not merge — the caller must reconcile).

Path Params
string
required
string
required
Body Params
string
length ≤ 255

Contact's first name.

string
length ≤ 255

Contact's last name.

string
length ≤ 255

Contact's email. Normalized to lowercase on write.

string
length ≤ 14

Contact phone in strict E164 format (+1XXXXXXXXXX). Required. Any other format — display "(NNN) NNN-NNNN", bare 10-digit, or dash/dot-separated — is rejected with HTTP 400.

string
length ≤ 255

Optional job title.

string
length ≤ 1000

Optional free-form notes.

Responses

401

Unauthorized (test-mode mismatch).

403

Forbidden (platform mismatch).

404

Merchant not found, or contact not found on this merchant.

409

Patch would create a canonical-identity collision with another contact.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json