Create Ephemeral Inbox
Create an inbox that expires automatically after its configured lifetime.
Create an inbox that expires automatically after its configured lifetime.
Scope: email_testing.inboxes.write
Request Body
domain_idstringoptionalThe ID of the custom domain to create the inbox on. Leave it out to use the shared sandbox domain (sandbox.maileroo.net).
local_partstringrequiredThe part of the address before the @, for example signup-tests for [email protected].
ttl_secondsintegeroptionalHow long until the inbox expires, in seconds. If you leave it out, your plan's default lifetime for ephemeral inboxes applies.
Sample Request
Request
curl -X POST "https://api.maileroo.com/v1/email-testing/mailboxes/ephemeral" \
-H "Authorization: Bearer roo_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"local_part":"ci-run","ttl_seconds":3600}'Sample Response
The response is wrapped in a data object.
Response
{
"data": {
"id": "35a3cb89-ea59-4ea3-8edc-a5c5f7bf0bda",
"account_id": "12345",
"domain_id": "sandbox",
"local_part": "ci-run",
"address": "[email protected]",
"kind": "ephemeral",
"smtp_response": "accept",
"invisible": false,
"expires_at": "2025-01-01T13:00:00Z",
"created_at": "2025-01-01T12:00:00Z"
}
}Errors
400 Bad Request— the request parameters are invalid.404 Not Found— the referenced resource does not exist or is not owned by the account.429 Too Many Requests— the account reached its test-inbox limit.