DeadDrop — Inboxes for agents
Programmable receive-only email inboxes for the agentic era. No JavaScript required to use the API.
Quick Start
- Register:
POST https://api.deaddrop.zone/account/register with {"email":"you@example.com"}
- Verify via the secure link emailed to you
- Create an inbox:
POST https://api.deaddrop.zone/inboxes with Authorization: Bearer dd_live_...
- Read messages:
GET https://api.deaddrop.zone/inboxes/{id}/messages
Key Capabilities
- Ephemeral inboxes — no account needed, 1-hour TTL:
POST https://api.deaddrop.zone/inboxes/ephemeral
- Persistent inboxes — custom slugs, webhook delivery, collaborators
- OTP & link extraction — parsed on receipt, available in the
parsed field
- Webhooks — push delivery with signed payloads and exponential backoff retry
- Real-time streaming — Server-Sent Events on
/inboxes/{id}/stream
API Reference
Response Format
All responses use a standard envelope:
// Success
{"ok": true, "data": { ... }}
// Error
{"ok": false, "error": {"code": "ERROR_CODE", "message": "..."}}
Authentication
Authenticated endpoints require a Bearer token: Authorization: Bearer dd_live_your_key
Ephemeral inbox endpoints require no authentication.
Links