List messages (POST)

Same as List messages, with the parameters in a JSON body instead of the query string. Useful when page_token is long, because nothing needs URL-encoding.

Returns messages from one mailbox, newest first, with the full message content.

Paging. Send mailbox_uid and, optionally, limit. If pagination.next_page_token is a string, call again with the same parameters plus page_token set to that value. Stop when next_page_token is null. See Paging Through a Mailbox for the full guide.

Across the workspace. If you leave out mailbox_uid, you get the newest messages from up to 10 active mailboxes in the workspace in one response, with no paging. A mailbox that cannot be read at that moment is left out of the result. To read every message, list each mailbox on its own.

Errors from the mailbox provider. When Google or Microsoft rejects the request, you get 400. When the provider is limiting requests for the mailbox, you get 429, with a Retry-After header when the provider gives a wait time. The message is the provider's own description, or one of these sentences: The email provider rejected the request. or The email provider is rate limiting this mailbox. Please try again later.

Any parameter not listed here is rejected with 400.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location 'https://api.inboxkit.com/v1/api/email/message/list' \ --header 'X-Workspace-Id: 8b2d4c6e-0000-4000-8000-000000000010' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "mailbox_uid": "7c1e2a90-0000-4000-8000-00000000a001", "limit": 50, "labels": [ "INBOX" ] }'

{ "error": false, "message": "Messages retrieved successfully", "data": { "messages": [ { "id": "18f3a9c2b7d41e05", "threadId": "18f3a9c2b7d41e05", "labels": [ "SENT" ], "subject": "Quick question about your Q3 hiring", "from": "Jane Cooper <[email protected]>", "to": [ "[email protected]" ], "cc": [], "date": "Tue, 10 Nov 2026 09:30:12 +0000", "body": { "text": "Hi Sam,\r\n\r\nI noticed you are hiring for three sales roles...", "html": "<div>Hi Sam,</div><div>I noticed you are hiring for three sales roles...</div>" }, "snippet": "Hi Sam, I noticed you are hiring for three sales roles...", "attachments": [], "read": true, "mailbox_uid": "7c1e2a90-0000-4000-8000-00000000a001" }, { "id": "18f3a7e01c9b2f44", "threadId": "18f3a6d5e2a01b77", "labels": [ "INBOX", "UNREAD" ], "subject": "Re: Partnership idea", "from": "Alex Morgan <[email protected]>", "to": [ "[email protected]" ], "cc": [ "[email protected]" ], "date": "Tue, 10 Nov 2026 08:02:47 +0000", "body": { "text": "Thanks Jane, Thursday works for us.", "html": "" }, "snippet": "Thanks Jane, Thursday works for us.", "attachments": [ { "id": "ANGjdJ8example0001", "filename": "proposal.pdf", "mimeType": "application/pdf", "size": 48213 } ], "read": false, "mailbox_uid": "7c1e2a90-0000-4000-8000-00000000a001" } ], "pagination": { "page": 1, "limit": 2, "hasMore": true, "next_page_token": "09284715563019847261" } } }

List messages (POST)

Request

Responses