Conversations tools
Read and answer the email and text replies contacts send, assign them to a teammate and close them when done.
list_conversations
List open or closed contact conversations, 50 per page. Use an assignee user ID or unassigned/all.
statusenum- open | closed
assigneestringchannelenum- email | sms | note | event
searchstringcursorstringteamstringrequired- Brand/team to act on (slug or id) → X-Cadence-Team. Required — your account key authorizes every brand you own, so this picks which one.
get_conversation
Read a contact thread including automated history, 100 entries per page.
idstringrequiredcursorstringteamstringrequired- Brand/team to act on (slug or id) → X-Cadence-Team. Required — your account key authorizes every brand you own, so this picks which one.
send_contact_message
Send a human email or SMS, or record a note. Requires a stable client_key UUID. All consent, suppression, reply binding and quota gates apply. A reply exception names a verified inbound message from the same address in the last seven days.
contact_idstringrequiredchannelenumrequired- email | sms | note
bodystringrequiredsubjectstringreply_to_message_idstringclient_keystringrequiredteamstringrequired- Brand/team to act on (slug or id) → X-Cadence-Team. Required — your account key authorizes every brand you own, so this picks which one.
update_conversation
Assign, unassign, close or reopen a conversation. Closing requires the inbound_seq you saw; a newer reply returns 409.
idstringrequiredstatusenum- open | closed
seen_inbound_seqnumberassignee_user_idstring | nullteamstringrequired- Brand/team to act on (slug or id) → X-Cadence-Team. Required — your account key authorizes every brand you own, so this picks which one.