Update Contact

Change only the fields you send. customFields are merged into the stored values (send null for a key to remove it) and re-checked against the contact's template; phone: null / email: null clear them.

Security:

  • The organisationId in the URL must match the organisation your JWT was issued for — requests for a different organisation fail with 401.
  • Requires CRM_ADMIN, ACCOUNT_OWNER, or CRM_BOT role; other roles receive 403.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Your organisation UUID (returned as org from the /token endpoint).

string
required

A contact id (contactId).

Body Params
lastName
object | null
phone
object | null

E.164 (+919876543210), or the national number with countryCode. Send null to clear.

string

With a national phone.

email
object | null
customFields
object

Values keyed by custom field id (see GET …/fields), checked against the field types; required fields must be present. On update they are merged into the stored values — send null for a key to remove it.

string
length ≤ 100
Responses

400

Bad request — invalid phone/email or custom field validation failed

401

Unauthorized — invalid/expired JWT or organisation ID does not match the token

403

Forbidden — role not permitted

404

Contact not found

429

Too many requests

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