← Catalog

email.inbox

live

Create (or fetch) a sending inbox owned by your organization, on the shared domain or on a domain you verified with email.domain. Idempotent per name.

live coverage

AgentMail: all inputs ✓

✓ marks a combination proven with a real provider call. Others are wired and unit-tested; their first live run verifies them.

Providers

ProviderStatus
AgentMail live

Billing

Unit: per_inbox · unmatched results billed: no
Charged once when an inbox is created; calling again with the same name returns the existing inbox free.

The exact price is returned by /v1/inspect before every call and reserved on execution.

Run it

curl https://api.routergrowth.com/v1/run \
  -H "Authorization: Bearer $ROUTERGROWTH_API_KEY" \
  -d '{
    "capability": "email.inbox",
    "input": {  },
    "routing": {"provider": "auto"}
  }'

Input schema

{
  "properties": {
    "display_name": {
      "type": "string"
    },
    "domain": {
      "description": "A domain verified with email.domain; omitted = shared agentmail.to address",
      "type": "string"
    },
    "name": {
      "default": "main",
      "description": "Inbox name; on your own domain this is the address\u0027s local part, e.g. \"guillaume\"",
      "type": "string"
    }
  },
  "type": "object"
}

Normalized output fields

inbox_id · address · display_name · created