Skip to main content
PATCH
/
contacts
curl --request PATCH \
  --url https://brew.new/api/contacts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "[email protected]",
  "firstName": "Johnny",
  "customFields": {
    "company": "Acme Corp",
    "department": "Engineering"
  }
}
'
{
  "success": true,
  "data": {
    "email": "[email protected]",
    "firstName": "<string>",
    "lastName": "<string>",
    "subscribed": true,
    "customFields": {},
    "createdAt": 123,
    "updatedAt": 123,
    "automations": {
      "triggered": 123,
      "errors": [
        "<string>"
      ]
    }
  },
  "meta": {
    "requestId": "<string>"
  }
}

Authorizations

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

Contact updated successfully

success
enum<boolean>
required
Available options:
true,
false
data
object
required
meta
object