Update a contact

Update a contact by email address. Custom fields are merged with existing values (not replaced).

Permission required: contacts or all

Protected fields (cannot be updated):

• email (used as lookup key)
• createdAt
• updatedAt

Note: Automations are now triggered via the dedicated automation trigger endpoint (/v1/automations/{automationId}/trigger), not through contact updates.

PATCH /contacts

cURL

basicUpdate

curl --request PATCH \
  --url https://brew.new/api/contacts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "[e-mail]",
  "firstName": "Johnny",
  "customFields": {
    "company": "Acme Corp",
    "department": "Engineering"
  }
}
'

200

{
  "success": true,
  "data": {
    "email": "[e-mail]",
    "firstName": "<string>",
    "lastName": "<string>",
    "subscribed": true,
    "customFields": {},
    "createdAt": 123,
    "updatedAt": 123,
    "automations": {
      "triggered": 123,
      "errors": [
        "<string>"
      ]
    }
  },
  "meta": {
    "requestId": "<string>"
  }
}

Authorizations

BearerAuthApiKeyAuth

Authorization · string · header · required

Use Authorization: Bearer brew_xxxxx header

Body

application/json

email · string<email> · required

Email address of contact to update (lookup key)

firstName · string

lastName · string

subscribed · boolean

customFields · object

Custom fields to merge (not replace)

triggerAutomations · boolean · default: false

If true, triggers field_update automations for changed fields. The response will include an automations object with trigger results.

Response

200

application/json

Contact updated successfully

success · enum<boolean> · required

Available options: true, false

data · object · required

Show child attributes

meta · object

Show child attributes