Documentation menu
POST/v1/keys/self/email
Access and price
| Auth | An API key, as Authorization: Bearer snk_… or ?api_key=snk_…. Not metered: it draws no quota and no credit. Needs a full key; a browser (maps) key is refused. |
|---|---|
| Price | Not metered: no quota, no credit. |
What it does
Quota-free like the rest of /v1/keys/self, and capped at
identity::MAX_EMAIL_ADDS_PER_KEY_PER_DAY per key and
identity::MAX_EMAIL_ADDS_PER_IP_PER_DAY per IP (an IPv6 /64 counts
as one) per UTC day, and at the per-network plus per-address mail
budget every signup already has. Unlike signup, a spent mail budget is
a 429 here: no code is minted that was not mailed, so the budget also
caps the codes anyone can guess at for one mailbox.
The answer is the same whether or not the address already has an account: a code is mailed either way, and only redeeming it (which takes the code from the mailbox) can tell.
Call it
curl -fsS -X POST "https://api.mapmap.ai/v1/keys/self/email" \
-H "Authorization: Bearer $MAPMAP_KEY" \
-H "Content-Type: application/json" \
-d '{"email":"string"}'Request body
application/json · AddEmailRequest
| Field | Type | Required | Description |
|---|---|---|---|
| string | yes | The address to add to the calling email-less key. |
Example: A request assembled from this schema's own field examples, enums, defaults and types; not a recorded call
{
"email": "string"
}Responses
POST /v1/keys/self/email/verify| Field | Type | Required | Description |
|---|---|---|---|
| expires_in_min | integer | yes | Minutes the code stays valid. |
| pending_email | string | yes | The address the code was sent to, as it will be stored (lowercased). |
| verify | string | yes | What happens next. |
Example: A response assembled from this schema's own field examples, enums, defaults and types; not a recorded call
{
"expires_in_min": 0,
"pending_email": "string",
"verify": "string"
}emailapplication/problem+json · Problem
unauthorized)application/problem+json · Problem
maps-scoped) key on a route that needs a full-scope key (scope-insufficient)application/problem+json · Problem
application/problem+json · Problem
text/plain
email-undeliverable: the mail provider refused this address, so no code was sent and nothing is pending; ask for the address againapplication/problem+json · Problem
application/problem+json · Problem
mail-unavailable: the code mail could not be handed to the mail provider, so no code exists; retry laterapplication/problem+json · Problem
request-timeout)application/problem+json · Problem
Error bodies follow the shared problem model documented on API conventions.
Also under Keys and account
Generated from https://api.mapmap.ai/openapi.json on 2026-11-18 · operationId add_email