Guides · Tag
api
37 guides tagged api.
Inboxes · Sep 30, 2026
Thread ID vs Message-ID in an Agent Inbox
Agent email thread ID vs message ID vs the Message-ID header: which to store, which a counterparty can forge, and what reply_to_message_id accepts.
Integrations · Sep 29, 2026
n8n AI Agent Gmail Node: Invalid Email Address
Why the n8n AI agent Gmail node throws an invalid email address error: it only checks for an @. The model outputs that trip it, and the ones that slip past.
Developers · Sep 29, 2026
What message.submission_unknown Actually Means
The send was attempted and nobody knows if it went out. What message.submission_unknown means, the silent path to it, and why resending is the wrong move.
Developers · Sep 28, 2026
Retry, Backoff and Error Handling for Agent Email
Agent email error handling that sorts every error by whether a retry can help: a decision table, what backs off, and what goes to a human.
Developers · Sep 28, 2026
Validating an Address Before Your Agent Sends
How to validate an email address before your agent sends: the syntax and DNS checks that are safe to run, and why probing the mailbox is not.
Inboxes · Sep 28, 2026
Cc, Bcc and Reply-All Rules for Agents
The recipient rules an agent should follow on reply-all: who goes in To, what to keep in Cc, why Bcc never carries forward, and what each extra name costs.
Developers · Sep 28, 2026
Handling PDF Attachments in an Agent Inbox
How to handle PDF attachments in an AI agent's email: upload in three calls, pass only att_ IDs to the model, and read inbound files in code, not in context.
Controls · Sep 27, 2026
Stopping an Infinite Agent Auto-Reply Loop
Four stopping rules that end an agent email loop with an auto responder: a thread reply budget, auto-reply signals, a sender window, and an approval gate.
Controls · Sep 27, 2026
Export an Agent's Email History, Then Deactivate
Export agent email history as NDJSON, verify the checksums, then deactivate the project, knowing the deletion job erases no stored mail.
Inboxes · Sep 26, 2026
How Many Tokens an Email Thread Really Costs
How many tokens does an email thread use? We built a 10-message thread and counted: 4% was new text. Here is the retrieval pattern that fixes it.
Inboxes · Sep 26, 2026
Stripping Quoted Reply Text Before the Model Sees It
Strip quoted reply text before an email agent reads it: client quote markers, a parsing order, and the replies where the quote is the message.
Developers · Sep 26, 2026
Resume an Agent Workflow When a Reply Arrives
How to resume an agent workflow when an email reply arrives: key on thread_id, dedupe message.received by event ID, and catch replies that break the thread.
Inboxes · Sep 26, 2026
How an AI Agent Actually Reads Its Inbox
How to let my agent read its email: list threads, page messages, fetch a body, and the ordering rules that decide if it sees a reply before it acts.
Developers · Sep 23, 2026
Agent Email Polling vs Webhooks: A Decision Table
Agent email polling vs webhooks, decided on failure modes: cursor semantics, event-id dedup, and the exact 4xx codes that kill a delivery on the first try.
Integrations · Sep 23, 2026
A LangChain Email Tool That Can Receive
A langchain email tool that receives as well as sends: the current ToolRuntime interface, idempotency keys that survive a resume, and which events fire.
Integrations · Sep 23, 2026
Dify Email Integration: An Inbox per AI Agent
Dify's email plugin sends as one workspace SMTP account. Give each AI agent workflow its own inbox, a scoped key, and sends that survive node retries.
Integrations · Sep 23, 2026
Letta Agent Email Address: Store Thread IDs, Not Text
Give a Letta agent email address durable context: keep thread IDs in a memory block, rehydrate from the threads endpoint, and see what body_available hides.
Integrations · Sep 23, 2026
Vercel AI SDK: Send and Receive Agent Email
Wire the AI SDK tool helper to a real inbox, then survive the inbound webhook: which status codes get retried, and which one silently discards the event.
Inboxes · Sep 23, 2026
What Happens When an Agent's Email Allowance Runs Out
Sending returns HTTP 402, not 429. What keeps working, how a unit is counted, which reservations stay held, and the upstream quota you do not control.
Integrations · Sep 22, 2026
AutoGen Agents That Send Email Without SMTP
Make an AutoGen agent send email without SMTP: a REST send tool, an Idempotency-Key bound to the turn, and the inbound half the examples all skip.
Developers · Sep 22, 2026
Email MCP Server OAuth vs API Key: the 401 Trap
Email MCP server OAuth vs API key: a valid key gets 401 invalid_token at /mcp, not 403, so rotation never helps. What each credential carries.
Integrations · Sep 22, 2026
CrewAI Email Integration: One Inbox, Two Keys
A CrewAI email integration where the inbox is shared and the credential is not: read-only scopes for the researcher, messages:send for one sender agent.
Integrations · Sep 22, 2026
Email Tools for the OpenAI Agents SDK
Wire the OpenAI Agents SDK to an agent-owned inbox: one hosted MCP config or hand-written function tools, a six-tool surface, and a send tool that is absent.
Developers · Sep 22, 2026
Is a mail.invalid Test Email Address Safe?
Why a mail.invalid test email address is safe: the .invalid TLD can never resolve, so a misrouted test send is unsendable rather than merely intercepted.
Integrations · Sep 22, 2026
Make.com Scenarios With an Agent-Owned Inbox
Make a Make.com AI agent send email from its own address: the HTTP call, an Idempotency-Key that survives Make's retry, and inbound events.
Integrations · Sep 22, 2026
Pydantic AI Email Tool: Typed Send Results
Give a Pydantic AI email tool a discriminated union return type, so a model can never read accepted as delivered or a queued draft as a sent message.
Integrations · Sep 22, 2026
Give a Zapier Agent Its Own Email Address
Zapier's email actions send as the account you connected. Give a Zapier agent an email address of its own: the send call, the key, and inbound.
Developers · Sep 21, 2026
Agent Email API: Send, Receive and Reply in One Loop
Build the full two-way loop over REST: scoped keys, idempotent sends, the states a message moves through, inbound events, and replies that thread correctly.
Controls · Sep 21, 2026
Scoped Credentials for Agent Email: Read, Draft, Send
Give an agent the smallest useful email permission: project and inbox scoping, one-time secrets, draft-only grants, rotation, and revocation you can verify.
Integrations · Sep 21, 2026
LangGraph Agent Email Inbox: The Parts Outside the Graph
Build a LangGraph agent email inbox: resume a run from an inbound event, keep the approval gate outside the graph, and survive two emails at once.
Integrations · Sep 21, 2026
n8n AI Agent Email Inbox Without the Gmail Node
Wire an n8n AI agent email inbox to the HTTP Request node: the send call, an Idempotency-Key that survives every n8n retry, and signed inbound webhooks.
Developers · Sep 21, 2026
Keep an Agent's Replies in the Right Email Thread
How Message-ID, In-Reply-To and References decide threading, why subject matching breaks, and how to keep an agent reply in the right conversation.
Integrations · Sep 21, 2026
How to Give an AI Agent Its Own Email Address
Create a dedicated inbox, choose read, draft or send permission, connect over MCP or a scoped key, and prove a real round trip before granting send access.
Developers · Sep 21, 2026
Test an Agent's Email Without Sending Real Mail
Use non-routable test inboxes to simulate inbound mail, exercise drafts, approvals and webhooks, and verify agent behavior before a live message goes out.
Developers · Sep 21, 2026
Test an Agent's Inbound Email Loop in CI
A routable test mailbox needs a message actually transmitted. Inject one instead: a CI job asserting received, parsed, threaded and replied.
Integrations · Sep 20, 2026
MCP or API Key for Agent Email? How to Choose
Remote MCP over OAuth or a project-scoped REST key: what each can and cannot do, who authorises it, how revocation differs, and why teams use both.
Developers · Sep 20, 2026
Idempotency Keys: Stop an Agent Sending Duplicate Emails
How send idempotency works: canonical payload hashing, the 30-day replay window, conflict versus expiry, and why retrying an unknown outcome is unsafe.