Guides · email · Everyday developer services

AgentMail API

Email inboxes for AI agents via API. Free sign-up gives inboxes on AgentMail's domain; custom domains need DNS records.

Researched · not yet run liveLast researched 25 October 2026 · AgentMail · provider site

Researched, not yet run live. Built from the provider’s official pages (linked below). A person hasn’t walked this flow end to end yet, so check each step against the source.

Have ready

  • DNS access for your custom domain (only if using one) · Custom domains need MX, SPF, DKIM and DMARC records. [4]Needed for: Add custom domain DNS records

Steps

Steps marked “human step” are ones only you can do: verapli never signs in, submits, pays or accepts terms for you.

  1. Sign in or create a AgentMail account

    Sign in to AgentMail. If you have no account yet, you create it yourself; verapli does not create accounts.

    • Guided by hand
    • Human step: You sign in

    Where: https://console.agentmail.to/

  2. Create an API key

    In the AgentMail console, generate an API key and store it as AGENTMAIL_API_KEY. Alternatively stripe projects add agentmail/api provisions it and syncs credentials.

    • Guided by hand
    • Human step: You press submit
    • After: Sign in or create a AgentMail account

    verapli captures AGENTMAIL_API_KEY here by plain code: encrypted in your browser, never shown to AI.

    Where: https://console.agentmail.to/

  3. Upgrade to a paid plan (custom domain only)optional

    Custom domains require a paid plan.

    • Guided by hand
    • Human step: You add payment details
    • After: Create an API key
  4. Add custom domain DNS recordsoptional

    Add the records the console returns - MX at @ (receiving) and mail (bounce), one SPF TXT at the MAIL FROM host, the DKIM selector TXT records, and DMARC (keep a single DMARC record and make sure it has rua=mailto:). Then click Verify Domain.

    • Guided by hand
    • After: Upgrade to a paid plan (custom domain only)
    The provider says
    DNS changes can take from a few minutes to 48 hours to propagate. [4]
    If something goes wrong (3)
    • DKIM fails on Route 53: Split the long DKIM TXT value into two quoted strings on the same line. [4]
    • Status Failed though records look right: Click Verify Domain in the console to re-verify. [4]
    • SPF includes spf.agentmail.to: Remove it; that host publishes no SPF record and must not be included. [4]

What you end up with

Env varSecretFormatWhat it is
AGENTMAIL_API_KEYsecretam_…AgentMail API key

Pricing

  • Free tier: 3 inboxes and 100 emails per day, no credit card required.
  • Custom domains require a paid plan.

Source [3]

For agents

The same entry as JSON: /api/v1/entries/agentmail/api · requirements /api/v1/requirements/agentmail/api · terms /api/v1/terms/agentmail/api.

Remote MCP (read-only, no auth)
claude mcp add --transport http verapli https://verapli.com/mcp

> "What do I need for AgentMail API, and how long will it take?"
  → tools/call requirements { "provider_id": "agentmail/api" }

Sources

  1. Stripe Projects CLI (Available providers) AgentMail is listed as a Stripe Projects provider (Email) · accessed 25 October 2026 · official
  2. projects.dev provider catalogue Catalogue service id agentmail/api · accessed 25 October 2026 · official
  3. AgentMail docs - Quickstart Create account and API key at console.agentmail.to; AGENTMAIL_API_KEY env var; keys start with am_; packages agentmail and agentmail-cli; free 3 inboxes and 100 emails per day, no card; custom domains require a paid plan · accessed 25 October 2026 · official
  4. AgentMail docs - Custom domains MX at @ and mail, single DMARC with rua=mailto, SPF TXT at MAIL FROM host (example v=spf1 include:amazonses.com -all), DKIM TXT selectors, Route 53 255-char split, few minutes to 48 hours, statuses Pending/Verifying/Verified/Failed, Verify Domain · accessed 25 October 2026 · official

Provider rules change. This page is generated from verapli registry version 2026.1025.316; spotted something out of date? Tell us. AgentMail is not affiliated with verapli.