Get a message

GET

https://api.inboxkit.com/v1/api/email/message/{messageId}

Maintainer:Not configured

Returns one message with its full content.

Errors from the mailbox provider. When the message ID is not valid, you get 400. When the mailbox has no message with this ID, you get 404. 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., The message was not found. or The email provider is rate limiting this mailbox. Please try again later.

For Microsoft mailboxes, other errors from Microsoft can arrive with Microsoft's own status code.

URL-encode messageId, because Microsoft message IDs can contain characters such as =.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Query Params

Header Params

Responses

🟢200Message retrieved

application/json

The message.

Bodyapplication/json

🟠400Bad request

🟠401Unauthorized

🟠404Not found

🟠429Too many requests

🔴500Server error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.inboxkit.com/v1/api/email/message/18f3a9c2b7d41e05?mailbox_uid=7c1e2a90-0000-4000-8000-00000000a001' \
--header 'X-Workspace-Id: 8b2d4c6e-0000-4000-8000-000000000010' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "error": false,
    "message": "Message retrieved successfully",
    "data": {
        "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"
    }
}

Modified at 2026-11-11 09:37:16

List messages (POST)

WebhookPayload