Sign in
latestOpenAPI 3.0.02026-08-21308337618.8 KB

93af2e90fb6a

S2S Contacts

Create conversation

Open a conversation for a contact, authored as the contact. Pass workflowId to start a workflow, or agentId to engage an AI agent. The contact is created on the fly if it does not exist yet.

post/s2s/contacts/{userId}/conversations

Path parameters

userIdstring required

Request body

titlestring
messagestring required

The customer's first message.

attributesRecordStringUnknown

Construct a type with a set of properties K of type T

sourcestring

Free-form source tag, e.g. "abb-mobile".

tagsstring[]
workflowIdstring

Start this workflow immediately (wf_… or bare id). Mutually exclusive with agentId.

agentIdstring

Engage this AI agent directly. Mutually exclusive with workflowId.

Response

Created

idstring required
numbernumber double
titlestring
typestring
statusstring
closedboolean required
archivedboolean required
unreadboolean required
workflowActiveboolean required
workflowIdstring
attributesRecordStringUnknown

Construct a type with a set of properties K of type T

createdAtstring date-time
lastActivityAtstring date-time