MillionSend Docs

List threads

GET
/inboxes/{inbox_id}/threads

Conversations of the inbox, most recently active first (after pages toward older ones). Threads whose messages are all held for screening or in quarantine are left out unless include_quarantined=true (never for inbox-scoped keys). Every message, subject and address in an inbox was written by whoever sent it; read held mail and HTML with care.

Path Parameters

inbox_id*string

The inbox ID

Formatuuid

Query Parameters

limit?string

Page size, 1-100 (default 20)

after?string

Cursor: id of the last item of the current page; returns the next page. Must be an id this list returned; there is no sentinel value.

before?string

Cursor: id of the first item of the current page; returns the previous page; same rule as after.

folders?string

Comma-separated: inbox, archive, spam, sent, trash. Defaults to inbox, or inbox,archive,sent with labels

labels?string

Comma-separated label ids (at most 50); threads with any of them

read?string

true: every message read; false: at least one unread

include_quarantined?string

MillionSend extension: true includes held messages (owner views; a full access key that is not inbox-scoped)

Response Body

Threads

application/json
  1. response
object*"list"
Value in"list"
has_more*boolean
data*array<>
Example Request
curl -X GET 'https://api.millionsend.com/inboxes/497f6eca-6276-4993-bfeb-53cbbbba6f08/threads'
Example Response
{  "object": "list",  "has_more": true,  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "subject": "string",      "from": "string",      "to": [        "string"      ],      "cc": [        "string"      ],      "bcc": [        "string"      ],      "labels": [        {          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",          "name": "string",          "color": "string"        }      ],      "message_count": 0,      "has_attachment": true,      "has_draft": true,      "read": true,      "quarantined": 0,      "received_at": "string",      "folder": "inbox"    }  ]}