ConversationsConversations

Create a new conversation

Create a new conversation. If end_user_id is not provided, the system creates a new end user automatically. The maximum request size is 10MB, and metadata must not exceed 4KB.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
channel_idstringRequiredformat: "id"
The ID of the channel to create a conversation in
end_user_idstringOptionalformat: "id"
The ID of the end user participating in the conversation. If not provided, the system will create a new end user automatically.
metadatamap from strings to strings or booleans or integers or doublesOptional
A dictionary of key value pairs assigned to the conversation. Note: This metadata does not create or set Ada metavariables. To create or update metavariables, use the End Users API. - `metadata` keys may only be of type: `string` - `metadata` values may only be one of type: `string`, `boolean`, `integer`, or `number` (float)

Response

Conversation created
idstringRead-onlyformat: "id"
The ID of the conversation
channel_idstring
The ID of the channel
end_user_idstringformat: "id"
The ID of the end user participating in the conversation
statusenumRead-only
The status of the conversation
Allowed values:
created_atstringRead-only
The date and time the conversation was created
updated_atstringRead-only
The date and time the conversation was last updated
metadatamap from strings to strings or booleans or integers or doubles
A dictionary of key value pairs assigned to the conversation. Note: This metadata does not create or set Ada metavariables. To create or update metavariables, use the End Users API. - `metadata` keys may only be of type: `string` - `metadata` values may only be one of type: `string`, `boolean`, `integer`, or `number` (float)

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error