Skip to main content
POST
Create a contact and conversation

Authorizations

Authorization
string
header
required

Workspace API token created in Settings → API. Tokens start with adraa_.

Body

application/json
email
string<email>
required
name
string
Example:

"Jane Doe"

channel
enum<string>
default:email
Available options:
email,
web
message
string

Optional first message sent right after the conversation opens.

Maximum string length: 2000

Response

201 - application/json

Conversation created or reused

created
boolean
Example:

true

conversation
object
contact
object
message
object | null

The first message, if one was sent.