Skip to main content
POST
/
api
/
v1
/
cdp
/
people
Upsert a person
curl --request POST \
  --url https://app.useboom.ai/api/v1/cdp/people \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "externalId": "user_123",
  "attributes": {
    "email": "a@b.com",
    "plan": "pro",
    "mrr": 49
  }
}
'
{
  "externalId": "user_123",
  "created": true
}

Authorizations

Authorization
string
header
required

Organization API key, sent as Authorization: Bearer boom_org_....

Body

application/json
externalId
string
required

Your stable identifier for this person.

Required string length: 1 - 255
attributes
object

Free-form attributes. Keys are registered in your attribute catalog. Full-replace on update.

Response

Person upserted

externalId
string
required
created
boolean
required

true if a new person was created, false if an existing one was updated.