Quickstart
Five minutes from signup to a passing wait-for-message request. Keep the API key in a secret manager; it is shown only once.
1. Create an account and API key
Sign in with Google or email, open API keys, and create a named key. Copy the secret immediately.
2. Create an inbox
POST creates a real address on test.inboxrhino.in and the Cloudflare receiving rule. Omit prefix to get a generated name.
curl --request POST https://api.inboxrhino.in/v1/inboxes \
--header "Authorization: Bearer $INBOXRHINO_API_KEY" \
--header "Content-Type: application/json" \
--header "Idempotency-Key: signup-test-1" \
--data '{"prefix":"signup-test"}'3. Send mail, then wait
Point the application under test at the returned address. The list route waits up to 180 seconds. A match returns 200; a timeout returns 204.
curl --get https://api.inboxrhino.in/v1/inboxes/INBOX_ID/messages \
--header "Authorization: Bearer $INBOXRHINO_API_KEY" \
--data-urlencode "wait_seconds=180" \
--data-urlencode "limit=1" \
--data-urlencode "include=content" \
--data-urlencode "subject=Verify"4. Delete the inbox
Deleting an inbox frees active-inbox quota immediately. Message deletion does not restore monthly email quota. Full request and error detail, plus a free Postman collection, is on the API reference.
curl --request DELETE https://api.inboxrhino.in/v1/inboxes/INBOX_ID \
--header "Authorization: Bearer $INBOXRHINO_API_KEY"