Sign in

v1

latestOpenAPI 3.1.02026-07-26359254.7 MB
Inbox

Create inbox category

<small>Requires the inbox:write scope (or a broader one that includes it).</small>

Creates a custom inbox category. Names must be unique within the team (case-insensitive).

post/v3/inbox/threads/categories

Request body

namestring required
color'gray' | 'green' | 'blue' | 'red' | 'yellow' | 'purple' | 'orange' | 'lightBlue' | 'olive' required

Response

Category created

idinteger required
namestring required
color'gray' | 'green' | 'blue' | 'red' | 'yellow' | 'purple' | 'orange' | 'lightBlue' | 'olive' required
isReservedboolean required

True for system-reserved categories (e.g., the default category). Reserved categories cannot be renamed, recoloured, or deleted.

unreadThreadsCountinteger required

Number of unread threads currently assigned to this category.