{"uid":"cap_5kPg2AfRCs3U3dKEeHsgU","slug":"agentmail-message-id-5b61a3d3","name":"AgentMail Get Message","description":"Get Message","url":"https://mpp.api.agentmail.to/v0/inboxes/:inbox_id/messages/:message_id?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["inbox_id","message_id"],"properties":{"inbox_id":{"type":"string","title":"InboxId","description":"The ID of the inbox."},"message_id":{"type":"string","title":"MessageId","description":"ID of message."}}},"responseSchema":{"type":"object","title":"Message","required":["inbox_id","thread_id","message_id","labels","timestamp","from","to","size","updated_at","created_at"],"properties":{"cc":{"type":"array","items":{"type":"string"},"title":"MessageCc","description":"Addresses of CC recipients. In format `username@domain.com` or `Display Name `."},"to":{"type":"array","items":{"type":"string"},"title":"MessageTo","description":"Addresses of recipients. In format `username@domain.com` or `Display Name `."},"bcc":{"type":"array","items":{"type":"string"},"title":"MessageBcc","description":"Addresses of BCC recipients. In format `username@domain.com` or `Display Name `."},"from":{"type":"string","title":"MessageFrom","description":"Address of sender. In format `username@domain.com` or `Display Name `."},"html":{"type":"string","title":"MessageHtml","description":"HTML body of message."},"size":{"type":"integer","title":"MessageSize","description":"Size of message in bytes."},"text":{"type":"string","title":"MessageText","description":"Plain text body of message."},"labels":{"type":"array","items":{"type":"string"},"title":"MessageLabels","description":"Labels of message."},"headers":{"type":"object","title":"MessageHeaders","description":"Headers in message.","additionalProperties":{"type":"string"}},"preview":{"type":"string","title":"MessagePreview","description":"Text preview of message."},"subject":{"type":"string","title":"MessageSubject","description":"Subject of message."},"inbox_id":{"type":"string","title":"InboxId","description":"The ID of the inbox."},"reply_to":{"type":"array","items":{"type":"string"},"description":"Reply-to addresses. In format `username@domain.com` or `Display Name `."},"thread_id":{"type":"string","title":"ThreadId","description":"ID of thread."},"timestamp":{"type":"string","title":"MessageTimestamp","format":"date-time","description":"Time at which message was sent or drafted."},"created_at":{"type":"string","title":"MessageCreatedAt","format":"date-time","description":"Time at which message was created."},"message_id":{"type":"string","title":"MessageId","description":"ID of message."},"references":{"type":"array","items":{"type":"string"},"title":"MessageReferences","description":"IDs of previous messages in thread."},"updated_at":{"type":"string","title":"MessageUpdatedAt","format":"date-time","description":"Time at which message was last updated."},"attachments":{"type":"array","items":{"type":"object","title":"Attachment","required":["attachment_id","size"],"properties":{"size":{"type":"integer","title":"AttachmentSize","description":"Size of attachment in bytes."},"filename":{"type":"string","title":"AttachmentFilename","description":"Filename of attachment."},"content_id":{"type":"string","title":"AttachmentContentId","description":"Content ID of attachment."},"content_type":{"type":"string","title":"AttachmentContentType","description":"Content type of attachment."},"attachment_id":{"type":"string","title":"AttachmentId","description":"ID of attachment."},"content_disposition":{"enum":["inline","attachment"],"type":"string","title":"AttachmentContentDisposition","description":"Content disposition of attachment."}}},"title":"MessageAttachments","description":"Attachments in message."},"in_reply_to":{"type":"string","title":"MessageInReplyTo","description":"ID of message being replied to."},"extracted_html":{"type":"string","description":"Extracted new HTML content."},"extracted_text":{"type":"string","description":"Extracted new text content."}}},"example":null,"exampleRequest":null,"tags":["email","inboxes","domains","drafts","threads","webhooks","messaging","ai","social"],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","priceSource":"unknown","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"1.00","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"free","summary":"Free","primary":null,"accepted":[]},"paymentMethods":[],"brandName":"AgentMail","brandSlug":"agentmail","brandBaseUrl":"https://agentmail.to","brandDocsUrl":"https://docs.agentmail.to","whatItDoes":"Retrieves a specific email message by inbox ID and message ID, returning full message content including headers, body, recipients, and metadata.","exampleAgentPrompt":"Pull up the full content of message msg_abc123 from inbox inbox_xyz456 in AgentMail — I need the subject, body, sender, and any CC recipients.","exampleUseCases":[{"title":"Extract email attachments for document processing","prompt":"Grab message msg_def789 from my inbox — I need to see all the headers and metadata so I can figure out what files came with it."},{"title":"Verify sender identity for security checks","prompt":"Can you pull up the full details of message msg_ghi012 from inbox inbox_lmn345? I need to check the sender, reply-to address, and any other header info to verify it's legitimate."},{"title":"Review customer inquiry before responding","prompt":"Get the complete content of message msg_jkl456 including the HTML and text body — a customer sent me something important and I need to read it all before my agent drafts a reply."}],"resultDescription":"Returns a Message object containing: inbox_id, thread_id, message_id, from, to, cc, bcc, reply_to, subject, text body, HTML body, labels, headers, preview, size in bytes, timestamp, created_at, and updated_at fields.","failureModes":["404 Not Found if inbox_id or message_id does not exist","401 Unauthorized if Bearer token is missing or invalid","400 Bad Request if inbox_id or message_id parameters are malformed","Message exists but inbox does not belong to the authenticated user"],"whenToPreferThis":"Use this endpoint when you need the full content and metadata of a single known email message within an AgentMail inbox. Prefer this over listing endpoints when you already have the message_id and need complete body text, HTML, headers, or recipient details for a specific message.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-05-15T01:33:38.889Z","lastSuccessfullyRanAt":"2026-05-15T01:33:38.889Z","lastHealthCheckAt":"2026-10-11T00:39:00.158Z","isFirstParty":false,"canonicalSlug":"agentmail-message-id-5b61a3d3"}