contacts

Identify or upsert a contact by external identifier

Resolves a contact by email or user_id, creating or updating it. Traits (plan, seats, mrr_cents, customer_since, last_usage_at) are accepted FLAT at the top of the body; arbitrary traits go under custom_attributes.

post/contacts/identify

Request

  • Base URL: https://corebee.ai/api/v1
  • URL: https://corebee.ai/api/v1/contacts/identify
  • Auth: HTTP bearer

Request body

emailstring email
user_idstring
namestring
planstring
seatsinteger
mrr_centsinteger
customer_sincestring date-time
last_usage_atstring date-time
custom_attributesobject

Example request

{
  "plan": "pro",
  "mrr_cents": 9900
}

Response

Resolved (existing contact updated)

Example response

{
  "data": {
    "name": "Jane Doe",
    "email": "jane@acme.com"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.