Skip to main content
POST
Create thread
Required scope: THREADS_WRITE

Behavior

Starts a discussion thread on a conversation item. content becomes the thread’s first comment, and the response is the full thread including that comment. Each item can have only one thread. If one already exists, the request returns 409 with code THREAD_ALREADY_EXISTS — find it with GET /v2/api/threads and add a comment instead.

Mentions

Mention teammates inline in content with @[Display Name](usr-xxxx) — see the mentions guide.

Errors

Authorizations

Authorization
string
header
required

Body

application/json
entity_type
enum<string>
required

Type of the conversation item to attach the thread to.

Available options:
CALL,
TEXT_MESSAGE,
CONVERSATION_NOTE
entity_id
string
required

ID of the conversation item (cll-*, msg-*, or not-*).

Example:

"cll-abc123"

content
string
required

First comment text (max 4000 characters). Mention teammates inline with @[Name](usr-...).

Example:

"Can someone call them back today? @[Jane Doe](usr-abc123)"

Response

Thread created with its first comment

data
object