Skip to main content
The Threads API lets you manage team discussion threads. A thread is a comment chain attached to a single conversation item — a call, an SMS message, or a conversation note — where teammates discuss that item without the contact seeing anything.

​
Key concepts

One thread per item — each conversation item can have at most one thread. Creating a second one returns 409 with code THREAD_ALREADY_EXISTS; find the existing thread and add a comment instead. Entity reference — a thread points at its item through entity_type (CALL, TEXT_MESSAGE, or CONVERSATION_NOTE) and entity_id (the item’s ID: cll-*, msg-*, or not-*). Comments — a thread is created with a first comment and grows from there. Only a comment’s author can edit it. Resolution — threads can be marked resolved and reopened. Resolving does not lock the thread — comments can still be added. Mentions — comments support the same @[Display Name](usr-xxxx) mentions as notes, with the same push, email, and in-app notifications. See the mentions guide.

​
Webhooks

Subscribe to the thread.created, thread.comment.created, thread.comment.updated, thread.resolved, and thread.unresolved events. See the Event catalog.

​
Endpoints

Get thread

A thread with all its comments

Find thread

Look up a conversation item’s thread by entity type and ID

Create thread

Start a thread on an item with a first comment

Create thread comment

Add a comment to a thread

Update thread comment

Edit a comment’s content (author only)

Resolve thread

Mark a thread as resolved

Unresolve thread

Reopen a resolved thread