API & automation
Scripts, schedulers and everything else you can drive over three HTTP endpoints.
4 guides
-
API & automationNew
Waiting for an email in code: polling without a webhook
What push and pull each cost you and why a receive-only service has neither webhook nor callback, the four-line loop everybody writes first and the five things wrong with it, why a deadline is the only stopping condition that survives a slow queue, how to choose an interval when the floor is one request a second, reading Retry-After instead of guessing, the whole table of refusals so a 404 is never mistaken for an empty mailbox, deciding which message is yours before you open it, acting exactly once when a poll is retried, and the server-side wait an agent can use instead of a loop.
29 min readIntermediate
-
API & automation
Node.js temp mail API: read an inbox with fetch, no key
A drop-in TypeScript module on the built-in fetch (fresh address, wait with a deadline, read, delete, download), the same in plain JavaScript, what changes on Deno and Bun, pagination with the before cursor, streaming an attachment to disk, 429 handling, a Vitest test, and a table of the ways this goes wrong in production.
19 min readIntermediate
-
API & automation
Python: receive email with a disposable inbox API, no key
A drop-in module on requests (fresh address, wait with a deadline, read, delete, download), the asyncio version on httpx that waits on five inboxes at once, pagination with the before cursor, attachments to disk, 429 handling, a pytest fixture, and a table of the ways this goes wrong in production.
23 min readIntermediate
-
API & automation
Disposable email API: automate an inbox from a script
The three calls in full, paging past the first fifty messages, the two separate rate budgets, deleting what you are done with, and the error slugs worth branching on.
22 min readIntermediate
Nothing matches that yet. Try a shorter word, or clear the filters — the library is still small and grows every week. Show every guide
Browse by topic
- Getting started What a disposable address actually is, how to open one, and what happens to the mail afterwards. 2 guides
- Testing & CI Reading real mail from a test suite: sign-up flows, verification codes, pipelines that must not flake. 5 guides
- Privacy & everyday use Signing up without handing over your real address — and being honest about where that stops working. 7 guides
- Your own domain One MX record, a catch-all inbox, and an address per service that you can burn one at a time. 2 guides
- AI agents & MCP Letting an agent open an inbox, wait for the confirmation code and carry on without you. 3 guides
- Email & deliverability MX, SPF, DKIM, DMARC, bounces, and why a message that was sent never arrived. 5 guides
- Troubleshooting When mail does not turn up, the API answers 404, or a form refuses the address outright. 1 guide
- Comparisons Named services, dated facts, and the places where this one loses. 1 guide
- Alternatives GrabMail against one named service at a time: what each does well, what each costs, and which to pick for which job. 16 guides
Everything here works on a free address
One click, no account, no card. Open one and follow along.