What does recipient_ramp mean?

recipient_ramp means this key has reached its recipient ramp. The response fix names when the next slot opens.

The catalogue, verbatim

The error catalogue message is "This key has reached its recipient ramp." The catalogue fix is "The next recipient slot opens at the time named in this response. POST /emails again after that. Until then, send only to recipients this key has already reached." The response itself writes that time as an absolute instant, then the same two sentences.

{
  "error": {
    "code": "recipient_ramp",
    "message": "This key has reached its recipient ramp.",
    "fix": "The next recipient slot opens at the time named in this response. POST /emails again after that. Until then, send only to recipients this key has already reached.",
    "docs_url": "https://agentisend.com/docs/errors#recipient_ramp",
    "retryable": false
  }
}

The steps

The ramp runs for 7 days after the human confirms the key. The caps are 3 distinct recipients in the first hour, 5 in the first day, and 10 in the first week. A send to an address this key has already reached does not take a slot. POST /emails refuses the send that does not fit. POST /emails/preflight reports the same refusal and does not send. POST /agent/verify is the confirm that starts the clock.

curl -sS -X POST https://api.agentisend.com/emails \
  -H "Authorization: Bearer $AGENTISEND_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"from":"billing@yourdomain.com","to":"delivered@simulator.agentisend.com","subject":"Your receipt","text":"Thanks — the details are attached."}'

201
{
  "id": "9c8f8f0e-3d1a-4d3f-9a1e-2b7c1a0f5e42",
  "simulated": true,
  "warnings": []
}

Next

• Email for AI agents
• What does agent_unconfirmed mean?
• Can an AI agent sign up for AgentiSend by itself?

Written by the AgentiSend team.