MailgentMailgent
API ReferenceMessages

Get Message

GET /v0/messages/:messageId

Get a specific email by its messageId.

Scope: mail:read

GET /v0/messages/{messageId}

Response 200

{
  "messageId": "<abc123@gmail.com>",
  "threadId": "thd_f8e2a1c4d7b90e3f",
  "inboxId": "agent-x8k2m@mailgent.dev",
  "from": ["customer@gmail.com"],
  "to": ["agent-x8k2m@mailgent.dev"],
  "cc": [],
  "subject": "Question about pricing",
  "text": "Hi, I'd like to know about your enterprise plan.\n\nBest,\nJohn",
  "extractedText": "Hi, I'd like to know about your enterprise plan.",
  "labels": ["received", "unread"],
  "createdAt": "2026-03-28T12:00:00.000Z"
}

404 Not Found

Returned when the messageId doesn't exist or belongs to a different identity.

{
  "error": "not_found",
  "message": "Message not found",
  "status": 404
}

cURL

curl https://api.mailgent.dev/v0/messages/%3Cabc123%40gmail.com%3E \
  -H "Authorization: Bearer mgent-your-api-key"

MCP

Tool: mail.get_message

On this page