{"uid":"cap_IYUliBvt2x5eMMMv8wtut","slug":"mermail-forward-email-59eae8af","name":"Mermail Forward Email","description":"An inbox and wallet for your AI agent. Find and nurture sales leads, resolve customer support, and handle online purchases with controlled payments.","url":"https://console.mermail.app/api/agent/v1/mailboxes/%7BmailboxId%7D/emails/%7BemailId%7D/forward?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"cc":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string","format":"email"}}]},"to":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string","format":"email"}}]},"bcc":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string","format":"email"}}]},"from":{"oneOf":[{"type":"string"},{"type":"object","required":["email","name"],"properties":{"name":{"type":"string"},"email":{"type":"string","format":"email"}}}]},"html":{"type":"string"},"text":{"type":"string"},"subject":{"type":"string"},"thread_id":{"type":"string"},"references":{"type":"array","items":{"type":"string"}},"attachments":{"type":"array","items":{"type":"object"}},"in_reply_to":{"type":"string"},"client_send_id":{"type":"string","format":"uuid"},"source_draft_id":{"type":"string"}}},"responseSchema":{"type":"json","example":{"status":"queued"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_U8E3sJz9zKPy24dwMQzpK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Forwards a specific email from an AI agent's Mermail mailbox to one or more recipients, optionally with CC/BCC, custom sender, body, and threading metadata.","exampleAgentPrompt":"Forward the email I just received in my Mermail inbox (mailbox abc123, email id msg456) to support@mycompany.com and CC billing@mycompany.com, keeping the original subject line and body.","exampleUseCases":[{"title":"Escalate customer support ticket","prompt":"That support email that just came into my Mermail inbox — forward it to our human support team at help@myteam.com and CC the account manager at sales@myteam.com so they're both in the loop."},{"title":"Route sales lead to CRM intake","prompt":"Forward the inbound sales inquiry in mailbox lead-inbox (email id lead789) to our CRM intake address crm@pipeline.io with the subject 'New Lead from AI Agent' and include the original message body."},{"title":"Relay purchase confirmation to buyer","prompt":"Forward the order confirmation email from my agent's mailbox (mailbox shop42, email shopmail99) to the customer at buyer@example.com so they have a copy in their inbox."}],"resultDescription":"Returns a JSON object with a 'status' field set to 'queued', indicating the forwarded email has been accepted and queued for delivery by Mermail's infrastructure.","failureModes":["Invalid mailboxId or emailId returns 404 not found","Malformed or missing 'to' address causes a 422 validation error","Unauthorized access to the mailbox returns 401 or 403","Duplicate client_send_id may be rejected or deduplicated silently","Attachment objects with missing fields may cause send failure","Payment not fulfilled (x402) results in 402 Payment Required"],"whenToPreferThis":"Use this endpoint when your AI agent has already received an email in a Mermail mailbox and needs to relay or forward that message — including its thread context — to another address. Prefer this over a generic send endpoint when you need to preserve threading metadata (in_reply_to, references, thread_id) or forward an existing email object by its ID rather than composing a brand-new message from scratch.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:48:03.742Z","isFirstParty":false,"canonicalSlug":"mermail-forward-email-59eae8af"}