Mail Buttons

The fastest path from AI agent to inbox

Mailbuttons Email API gives you a production-ready inbox layer that drops into your stack. Provision agent mailboxes, monitor every run, and ship human-quality replies—all through a single, standards-aligned API surface with optional vector memory so agents remember every thread.

Why teams choose Mailbuttons

  • Provision domains and inboxes programmatically—no ticket queue or manual provisioning
  • Tenant-scoped API keys with routing rules so you never juggle per-mailbox credentials
  • Live delivery analytics and structured logs built to debug automated traffic
  • Native hooks into your AI runtimes for parsing, routing, and escalation workflows

How it works

  1. Register or log in to issue a tenant API key from the dashboard
  2. Verify a domain with guided DNS records and automatic propagation checks
  3. Create mailboxes or agent identities through the Mailbuttons CLI or SDKs
  4. Send and receive via `/api/v1/jmap` using the Mailbuttons CLI or Python SDK, or plug in any compatible JMAP client while layering on Mailbuttons agent-memory extensions
  5. Watch delivery, parsing, and agent responses in real time with built-in observability
Start a free sandbox tenantLog in

JMAP-compatible quick start

Request a session and execute standard JMAP operations with a single endpoint—Mailbuttons extensions are opt-in for agent context:

# Save the payload once; reuse as needed
cat <<'EOF' >/tmp/mailbox-create.json
{
  "using": [
    "urn:ietf:params:jmap:core",
    "urn:ietf:params:jmap:mail"
  ],
  "methodCalls": [
    [
      "Mailbox/set",
      {
        "accountId": "{{accountId}}",
        "create": {
          "agent-inbox": {
            "name": "Agent Inbox",
            "parentId": null,
            "isSubscribed": true
          }
        }
      },
      "c1"
    ]
  ]
}
EOF
# Fetch the tenant-scoped JMAP session
curl -s https://emailapi.mailbuttons.com/api/v1/jmap/session   -H "Authorization: Bearer <TENANT_API_KEY>"
# Issue a JMAP request (email query in this example)
curl -s https://emailapi.mailbuttons.com/api/v1/jmap   -H "Authorization: Bearer <TENANT_API_KEY>"   -H "Content-Type: application/json"   --data @/tmp/mailbox-create.json

Note: Tenants can scope requests to specific agent mailboxes using the optional _mailbuttons.account hint inside the JSON body.

Manage domainsDeveloper docs