Programmable inboxes for automation

Email OTPs without leaving the test run.

OceanInbox lets KaleFlow agents create a mailbox, wait for inbound mail, search the latest messages, and extract login codes through a private API.

View API contract Request access

curl -X POST https://api.oceaninbox.com/v1/mailboxes \
  -H "x-api-key: $OCEANINBOX_API_KEY" \
  -d '{"ttlSeconds":3600}'

{
  "address": "kf-n7sq4r8m2p1d@oceaninbox.com",
  "expiresAt": "2026-07-04T19:30:00.000Z"
}

Mailbox lifecycle

One API flow for account signup tests.

Create

POST /v1/mailboxes

Receive

Mail lands on the existing Postfix/Dovecot host

Search

GET /v1/mailboxes/{address}/messages?search=code

Continue

GET /v1/mailboxes/{address}/otp

Uses the existing mail server.

The API is designed around the current Postfix and Dovecot setup in the ScaleMule account. Mailbox administration stays behind a restricted server-side adapter, while agents only receive scoped API access.

Searchable messages.

Tests can query recent mail by sender, subject, or body text, then request the latest 4-8 digit OTP code for the mailbox they just created.

Private by default.

The service requires API keys, stores mailbox credentials server-side, and avoids putting internal platform tokens into customer-facing applications.