← Catalog

email.messages

live

Messages in one of your inboxes, newest first: replies, bounces and opens as labels. Poll it after a send.

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_read · unmatched results billed: no

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.messages",
    "input": { "inbox_id": "..." },
    "routing": {"provider": "auto"}
  }'

Input schema

{
  "properties": {
    "after": {
      "description": "ISO timestamp",
      "type": "string"
    },
    "from": {
      "description": "Sender substring filters",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "inbox_id": {
      "type": "string"
    },
    "labels": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "limit": {
      "default": 20,
      "type": "integer"
    }
  },
  "required": [
    "inbox_id"
  ],
  "type": "object"
}

Normalized output fields

messages · count