Docs

createConversation

Creates a new Conversation. When creating a new Conversation, the required tags must be provided. See the specific integration for more details.

POST/v1/chat/conversations

Authorization

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

Header parameters

x-bot-idstringrequired
Bot id
x-integration-idstring
Integration id
x-integration-aliasstring
Integration alias

Request body

Conversation data

channelstringrequired
Channel name(max length: 200)
tagsobjectrequired
Tags for the Conversation
integrationNamestringdeprecated
[DEPRECATED] To create a conversation from within a bot, call an action of the integration instead.(max length: 200)

Response

Returns a Conversation object if creation succeeds. Returns an error otherwise

conversationobjectrequired
The Conversation object represents an exchange of messages between one or more users. A Conversation is always linked to an integration's channels. For example, a Slack channel represents a conversation.