Update contact.

PATCH/api/v1/contacts/{id}

Browse API endpoints

Contacts / CRM REST API

Scope: contacts:write

Include only the fields you want to change.

Code example

{
  "lifecycleStage": "customer",
  "tags": ["vip", "enterprise"]
}

Side effects:

Fires contact.updated webhook event
If tags added: fires contact.tag_added event per new tag
If lifecycleStage changed: fires contact.lifecycle_changed event

Loading endpoint details...

Build a request

Request example

Documented defaults and example values are ready. Change only the parameters you need.

Connection

Your CRM deployment URL

Replace the Bearer API key placeholder in the copied server-side code. No API key is entered or sent here.

Sub-account ID Agency keys onlyAgency-scoped keys require the X-Sub-Account-Id header.

Path parameters

id Required

Body parameters

lifecycleStage

tags

Edit the full JSON body

cURL

curl --request PATCH \
  --url 'https://your-crm.example.com/api/v1/contacts/ID_HERE' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{"lifecycleStage":"customer","tags":["vip","enterprise"]}'

This shows a static response from the documentation. It does not send a request to your CRM or use an API key.