MultiMail Agent API
The Agent API from MultiMail — 3 operation(s) for agent.
The Agent API from MultiMail — 3 operation(s) for agent.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/multimail-dev:multimail-dev-agent-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: MultiMail Agent API
version: 2.0.0
description: Email-as-a-Service for AI agents. Inbound email converted to markdown, outbound markdown converted to HTML. Built on Cloudflare Workers.
servers:
- url: https://api.multimail.dev
tags:
- name: Agent
paths:
/agent/auth:
post:
summary: Register agent via auth.md protocol
description: Initiates agent registration using verified_email identity assertion. Sends a 6-digit OTP to the provided email and returns a claim_token for completing the registration.
requestBody:
content:
application/json:
schema:
type: object
required:
- type
- assertion_type
- assertion
properties:
type:
type: string
enum:
- identity_assertion
description: Registration type. Only identity_assertion is supported.
assertion_type:
type: string
enum:
- verified_email
description: Assertion type. Only verified_email is supported.
assertion:
type: object
required:
- email
properties:
email:
type: string
format: email
maxLength: 320
requested_credential_type:
type: string
enum:
- api_key
description: Credential type. Only api_key is supported.
requested_oversight_mode:
type: string
enum:
- gated_all
- gated_send
- monitored
description: Optional initial oversight mode for the mailbox.
operator_name:
type: string
maxLength: 100
description: Optional operator name. Derived from email local part if absent.
responses:
'200':
description: Registration initiated
content:
application/json:
schema:
type: object
properties:
registration_id:
type: string
registration_type:
type: string
claim_url:
type: string
claim_token:
type: string
claim_token_expires:
type: string
format: date-time
post_claim_scopes:
type: array
items:
type: string
'400':
description: Invalid request (unsupported type, invalid email, etc.)
'429':
description: Rate limited
tags:
- Agent
operationId: postAgentAuth
x-operation-id-source: derived
/agent/auth/claim/view:
get:
summary: View OTP verification code
description: Human-facing page that displays the 6-digit OTP for agent registration. Linked from the verification email.
parameters:
- name: token
in: query
required: true
schema:
type: string
description: Claim view token from verification email
responses:
'200':
description: HTML page displaying the OTP
content:
text/html:
schema:
type: string
tags:
- Agent
operationId: getAgentAuthClaimView
x-operation-id-source: derived
/agent/auth/claim/complete:
post:
summary: Complete agent registration claim
description: Completes the auth.md registration by validating the claim_token and OTP. On success, atomically creates the tenant account and returns API credentials.
requestBody:
content:
application/json:
schema:
type: object
required:
- claim_token
- otp
properties:
claim_token:
type: string
maxLength: 512
description: Claim token returned from POST /agent/auth
otp:
type: string
pattern: ^\d{6}$
description: 6-digit OTP from verification email
responses:
'200':
description: Claim successful, credentials returned
content:
application/json:
schema:
type: object
properties:
registration_id:
type: string
status:
type: string
enum:
- claimed
credential_type:
type: string
enum:
- api_key
credential:
type: string
credential_expires:
type:
- string
- 'null'
scopes:
type: array
items:
type: string
'400':
description: Invalid claim token, wrong OTP, or expired
'409':
description: Already claimed
'429':
description: Too many attempts
'503':
description: Service unavailable (KV failure, fail-closed)
tags:
- Agent
operationId: postAgentAuthClaimComplete
x-operation-id-source: derived
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: 'API key (mm_live_...). Keys have scopes: read (list/read emails, mailboxes, contacts), send (send/reply/cancel emails), admin (manage mailboxes, API keys, billing, account), oversight (approve/reject pending emails).'