Ephemeral Postal is disposable E-mail for developers. Generate unlimited temporary mailboxes and use our API to wait for new emails, dispatch webhooks, check mail contents and manipulate the inbox.
Perfect for end-to-end, continous integration testing, monitoring or simply keeping your E-mail address private. Use Ephemeral Postal to check whether your outgoing mail is being delivered and to validate its contents, or to use the webhook to respond to issues brought up by mail from an external system.
Since any E-mail address can be used within your subdomain, ad-hoc mailboxes can easily be created, making it perfect for CI tests.
Integration tests: Run a test case where a user signs up with an Ephemeral Postal E-mail address. The test script can poll the inbox to ensure deliverability and check header and mail contents, etc.
Use whenever there is a case where easy and randomized programmatic access to E-mail would be helpful.
domain and token query
parameters.
Long-poll for a new email
https://api.ephemeralpostal.com/await?domain=...&token=...
This request will not return until a new email comes in for the domain,
or the timeout expires. The default timeout is 10 seconds. Subscribe
to increase this timeout. If an email has not come in by 10 seconds,
retry. If an email might have been missed in between retries, use the latest
endpoint.
Retrieve Latest Emails
https://api.ephemeralpostal.com/latest?domain=...&token=...&full
Retrieves the latest E-mails for the given domain. To return the full
(unparsed) MIME body of the email, include the full query
parameter. If the full query parameter is omitted, then a
filepath is returned in the response. Use this `filepath`
to retrieve the email body. If no mails exist,
an empty list is returned. Limit of 10 of the most recent messages. To
increase this limit, subscribe.
Email Body
https://api.ephemeralpostal.com/raw/<filepath>?domain=...&token=...&full
Returns the raw MIME body for the email given by
filepath as returned from the /latest endpoint.
Strict limits are in place to prevent abuse. These include limits on: E-mail size, attachments, storage duration, API request rate limits, etc. Subscribe to increase these limits.
If you would like server-triggered webhooks, please subscribe to unlock this feature.
Contact us to express your interest in any of these features. We would love to hear from you.