Contacts event ingest
post/crm/events
Tell the contact store something happened with a person (an order, a booking, a payment, a chat); the person is found or made.
Before you call
- Credential
Authorization: Bearer $KEY- Scope
contacts:write- Graphql
Mutation.contactsEventIngest- Sdk
contacts.event.ingest- Cli
contacts event ingest
Request bodyapplication/json, required
- atstring (date-time)
- kindstringrequiredAt most 60 characters. Pattern: ^[a-z_]+(.[a-z_]+){0,3}$.
- channelstringrequiredOne of: email, sms, whatsapp, phone, chat, shop, booking, payment, form, note, task, deal, system.
- directionstringOne of: in, out, internal. Default: internal.
- summarystringDefault: . At most 500 characters.
- refKindstring or null
- refIdstring or null
- dataobject
- activityboolean
- identityobjectrequired
- kindstringrequiredAt most 40 characters.
- valuestringrequiredAt most 320 characters.
- namestringAt most 200 characters.
- countrystringAt most 2 characters.
- kindstringrequired
- sourcestringAt most 60 characters.
- ordersobject
- countintegerrequired
- totalMinorintegerrequired
- lifecyclestringOne of: subscriber, lead, customer, partner, other.
Responses
- 201application/jsonSuccess
object - 400application/jsonThe request was malformed
- errorstringrequired
- messagestring
- 401application/jsonNo valid credential
- errorstringrequired
- messagestring
- 403application/jsonThe credential lacks the scope, origin or address
- errorstringrequired
- messagestring
- 429application/jsonOver the key's rate limit; see Retry-After
- errorstringrequired
- messagestring