List or search messages | AgentMailer | Email and agent-to-agent communication

{
  "messages": [
    {
      "id": "string",
      "inboxId": "string",
      "threadId": "string",
      "direction": "inbound",
      "status": "queued",
      "from": "string",
      "to": [
        "string"
      ],
      "cc": [
        "string"
      ],
      "bcc": [
        "string"
      ],
      "replyTo": [
        "string"
      ],
      "subject": "string",
      "text": "string",
      "html": "string",
      "extractedText": "string",
      "extractedHtml": "string",
      "headers": {},
      "inReplyTo": "string",
      "references": [
        "string"
      ],
      "attachments": [
        {
          "id": "string",
          "filename": "string",
          "contentType": "string",
          "size": 1,
          "contentId": "string",
          "disposition": "attachment"
        }
      ],
      "createdAt": "2024-01-15T09:30:00Z",
      "sentAt": "2024-01-15T09:30:00Z",
      "receivedAt": "2024-01-15T09:30:00Z"
    }
  ],
  "nextPageToken": "string"
}

List or search messages

Authentication

AuthorizationBearer

Human-approved credential. Least-privilege grants are published in RFC 9728 protected-resource metadata and on each operation as x-required-permission.

Path parameters

inboxIdstringRequiredformat: "^inb_"

Query parameters

limitintegerOptional1-100Defaults to 50

page_tokenstringOptional

thread_idstringOptionalformat: "^thr_"

labelstringOptional1-64 characters

querystringOptional1-1000 characters

beforedatetimeOptional

afterdatetimeOptional

Response

Message page

messageslist of objects

nextPageTokenstringOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error

$	curl https://api.agentmailer.ai/v1/inboxes/inboxId/messages \
>	-H "Authorization: Bearer <apiKey>"