Create Conversation

POST

Creates a conversation.

Request

This endpoint expects an object.
typeenumRequired
Allowed values: support
custom_schema_specobjectRequired

Requested custom schemas described abstractly. Every provided schema’s custom field must be specified, otherwise a bad request error is returned. If a new custom schema specifier is provided, then it will be added to the work, otherwise if a custom schema is omitted from the specifier, it remains unmodified.

metadataobjectRequired
stageobjectRequired

Sets an object’s initial stage.

custom_fieldsobjectOptional

Application-defined custom fields.

descriptionstringOptional

Description for the conversation.

groupstringOptional

The group that the conversation is associated with.

is_spambooleanOptional

Whether the conversation is spam.

memberslist of stringsOptional

The users in the conversation.

messageslist of objectsOptional

Initial messages on the conversation.

owned_bylist of stringsOptional

The users that own the conversation.

source_channelstringOptional

Whether the conversation is from a source channel.

tagslist of objectsOptional

Tags associated with the conversation.

titlestringOptional

The title for the conversation.

user_sessionslist of stringsOptional

The IDs of user sessions associated with the conversation.

Response

The response to creating a new conversation.

conversationobject
Built with