{"uid":"cap_bNWOUhoOFO010QwRT8W2x","slug":"agentmail-forward-705c638a","name":"AgentMail Forward Message","description":"Forward Message","url":"https://mpp.api.agentmail.to/v0/inboxes/:inbox_id/messages/:message_id/forward?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","title":"SendMessageRequest","properties":{"cc":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"title":"Addresses"},"to":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"title":"Addresses"},"bcc":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"title":"Addresses"},"html":{"type":"string","title":"MessageHtml","description":"HTML body of message."},"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":"SendMessageHeaders","description":"Headers to include in message.","additionalProperties":{"type":"string"}},"subject":{"type":"string","title":"MessageSubject","description":"Subject of message."},"reply_to":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"title":"Addresses"},"attachments":{"type":"array","items":{"type":"object","title":"SendAttachment","properties":{"url":{"type":"string","description":"URL to the attachment."},"content":{"type":"string","description":"Base64 encoded content of attachment."},"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."},"content_disposition":{"enum":["inline","attachment"],"type":"string","title":"AttachmentContentDisposition","description":"Content disposition of attachment."}}},"title":"SendMessageAttachments","description":"Attachments to include in message."}}},"responseSchema":{"type":"object","title":"SendMessageResponse","required":["message_id","thread_id"],"properties":{"thread_id":{"type":"string","title":"ThreadId","description":"ID of thread."},"message_id":{"type":"string","title":"MessageId","description":"ID of message."}}},"example":null,"exampleRequest":null,"tags":["email","inboxes","domains","drafts","threads","webhooks","messaging","ai","social"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"unknown","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_QOo3w_heAzwashZKQ3gUL","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"AgentMail","brandSlug":"agentmail","brandBaseUrl":"https://agentmail.to","brandDocsUrl":"https://docs.agentmail.to","whatItDoes":"Forwards an existing email message from an AgentMail inbox to one or more recipients","exampleAgentPrompt":"Forward the message with ID msg_abc123 from my inbox inbox_xyz456 to alice@example.com and bob@example.com, and cc manager@example.com — use the original subject line.","exampleUseCases":null,"resultDescription":"Returns a JSON object containing the new message_id and the thread_id of the forwarded message, confirming successful delivery of the forward.","failureModes":["Invalid inbox_id or message_id returns 404 not found","Missing or invalid Authorization bearer token returns 401 unauthorized","Invalid recipient email address format causes a 400 bad request","Inbox not found or not accessible returns 403 forbidden","Network or provider error returns 500 internal server error","Message already deleted or in trash may return 404"],"whenToPreferThis":"Use this endpoint when an AI agent needs to programmatically forward an existing email message from an AgentMail-managed inbox to one or more recipients, especially in automated workflows where agents receive emails and need to route or escalate them to humans or other systems. Prefer this over a generic send/compose endpoint when the intent is to forward (relay) an already-received message rather than compose a brand-new one.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T06:41:50.254Z","isFirstParty":false,"canonicalSlug":"agentmail-forward-705c638a"}