List Inbox

GET

/inbox

• Production
• QA

List inbox threads across email, SMS, and LinkedIn channels.

status accepts SENT, AI_RESPONDED or DRAFT (case-insensitive) and is forwarded to the channel handler; an unknown value returns 422.

CAVEAT — assignee: this cannot filter by an arbitrary email in this layer. ChannelsService.get_channels only exposes assigned_to_me (a boolean bound to the caller’s identity), so the value is used purely as a trigger to return the caller’s own assigned threads — NOT threads assigned to the requested email. For an org (machine) API key the caller identity is the synthetic [email protected], which owns no threads, so the result is effectively empty. A true per-assignee filter needs an assignee_email field on the shared ChannelRequest (out of scope for the dev-API layer).

Authorizations

• BearerAuth

Parameters

Query Parameters

channel

Any of:

InboxChannel

string

Allowed values: email sms linkedin

null

null

Filter by channel: email, sms, linkedin

sequence_id

Any of:

string

string

null

null

Filter by sequence (campaign) ID

status

Any of:

string

string

null

null

Filter by status

assignee

Any of:

string

string

null

null

Filter by assignee email

tag

Any of:

string

string

null

null

Filter by tag ID

page

Page number

integer

default: 1 >= 1

Page number

page_size

Items per page

integer

default: 50 >= 1 <= 100

Items per page

Header Parameters

X-Target-Org-Id

Any of:

string

string

null

null

Responses

200

Successful Response

object

data

required

Array<object>

object

assignees

Array<object>

object

key

additional properties

any

channel

required

string

contact

Any of:

object

object

key

additional properties

any

null

null

created_at

Any of:

string

string

null

null

from_number

Any of:

string

string

null

null

id

required

string

linkedin_account_id

Any of:

integer

integer

null

null

mailbox

Any of:

string

string

null

null

messages

Array<object>

object

content

Any of:

string

string

null

null

date

Any of:

string

string

null

null

from_address

Any of:

string

string

null

null

is_draft

boolean

message_id

Any of:

string

string

null

null

responder

Any of:

string

string

null

null

to_addresses

Array<string>

record_context

Any of:

Array<object>

Array<object>

A custom record pinned to the thread that this key may read (ENG-05, custom objects PR 3.7).

object

label

required

Plain text; never markup or a link

string

object_label

required

string

object_slug

required

string

record_id

required

string

revision

required

integer

null

null

record_context_unavailable

Any of:

integer

integer

null

null

status

Any of:

string

string

null

null

subject

Any of:

string

string

null

null

tags

Array<object>

object

key

additional properties

any

to_number

Any of:

string

string

null

null

updated_at

Any of:

string

string

null

null

pagination

Any of:

PaginationMeta

object

has_next

required

Whether there are more pages

boolean

limit

required

Items per page

integer

next_cursor

Any of:

string

string

null

null

notes

Any of:

Array<string>

Array<string>

null

null

page

required

Current page number (1-indexed)

integer

total

required

Total number of items

integer

total_available

Any of:

integer

integer

null

null

total_is_lower_bound

Any of:

boolean

boolean

null

null

null

null

422

Validation Error

object

detail

Array<object>

object

loc

required

Array

msg

required

string

type

required

string