Programmable inboxes for AI agents

Make email verification a normal API step.

OceanInbox gives every automation run a real @oceaninbox.com address, searchable messages, and a latest-OTP endpoint so signup tests keep moving without manual inbox access.

Create an account Read agent docs Dashboard

Root domain: @oceaninbox.com only
Latest first: sort=desc
Agent auth: x-api-key
Retention: 60s to 30d

signup-run-074live inbox

mailboxkf-8m2p1d@oceaninbox.com

waitingverification email

otp628491

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

curl "https://api.oceaninbox.com/v1/mailboxes/$ADDRESS/otp?sort=desc"

Built for verification flows

Agents can create the inbox, use it, and read it without leaving the flow.

Signup automation that reaches the inbox

Create the email before the browser flow starts, enter it into the product under test, then poll for the verification message.

Message search built for agents

Filter by sender, subject, body text, or HTML and ask for newest-first results so agents stop reading stale OTP codes.

Scoped account keys

Users create OceanInbox API keys for agents, track usage from the dashboard, and can rotate access without changing the test flow.

Mailbox lifecycle

One repeatable contract for account signup tests.

Create mailbox

POST /v1/mailboxes

Choose a handle or let OceanInbox generate one.

Use it in signup

name@oceaninbox.com

Give the target service a real inbox address.

Read latest mail

GET /messages?sort=desc

Search sender, subject, plain text, and HTML.

Extract the OTP

GET /otp?sort=desc

Return the newest numeric verification code.

Ready for the first test run

Create an API key, then let the agent own the inbox step.

The dashboard shows created mailboxes and account usage. The API docs give agents exact curl examples for creating mailboxes, reading messages, and extracting the latest code.

Create account Open docs

Private by default, explicit by API.

The service requires account-scoped API keys, tracks usage per OceanInbox account, and keeps mailbox controls behind authenticated API calls.