Create discussion/task conversation

post

https://api2.frontapp.com/conversations

Create a new conversation of type discussion or task. Both types only support comments. If you want to create a conversation that supports messages, use the Create message endpoint. If you want to add a comment to an existing conversation, use the Add comment endpoint.

Required scope: conversations:write

Body Params

type

string

enum

required

Conversation type

Allowed:

inbox_id

string

Inbox ID for the conversation. Either inbox_id OR teammate_ids must be provided (not both).

teammate_ids

array of strings

Teammates to add to the conversation. Either inbox_id OR teammate_ids must be provided (not both).

teammate_ids

subject

string

required

Subject of the conversation. Used as the title for tasks.

comment

object

Details for the starter comment. Required for discussions, optional for tasks.

description

string

length ≤ 65535

Description of the task. Only allowed when type is task.

due_at

number

Unix timestamp in seconds when the task is due. Must be in the future and within 50 years. Only allowed when type is task.

custom_fields

object

Custom fields for this conversation

Response

Language

Credentials

Bearer

JWT

Loading…

Response

Choose an example:

application/json

201A conversation