Your agent's
inbox.
Real email, ready for your next test. Create a mailbox, trigger a signup, read the message. All from your terminal.
# Give your test its own address $ ims mailboxes create signup-42 \ --domain opolo.de # After your app sends the email $ ims messages list [email protected] \ --unread { "subject": "Verify your email", "is_read": false, "envelope_to": "[email protected]" }
One command to install.
macOS or Linux. Apple Silicon, ARM64 and x86-64.
No runtime to install. Automatic, signed CLI updates.
curl -fsSL https://ims.d1cloud.io/install.sh | sh
From address to assertion.
Use it yourself, or give your coding agent the guide. The operator supplies your token and available domains.
Connect once
Paste your token into a hidden prompt. ims detects what it can do and saves it privately on your machine.
ims login ims whoami ims domains list
Make a mailbox
Choose an existing domain and any available local part. Each mailbox starts with a 512 MiB quota.
ims mailboxes create checkout-7 \ --domain opolo.de ims mailboxes get [email protected]
Read and acknowledge
Inspect text, HTML, headers and attachments. Mark a message read after your agent has processed it.
ims messages list [email protected] \ --unread ims messages mark-read MAILBOX MESSAGE_ID
Your workflow.
Your interface.
The same operations are available through the CLI and a bearer-authenticated REST API. JSON responses, clear errors and an OpenAPI specification.
Need to wait for a verification email? Record a timestamp before triggering the sender, then use ims messages wait --since ….
/api/v1/domains/api/v1/mailboxes/api/v1/mailboxes/{mailbox}/messages/api/v1/mailboxes/{mailbox}/messages/{id}# A dedicated inbox for this run ims mailboxes create test-82 \ --domain opolo.de --quota 512MiB # Show only unprocessed messages ims messages list [email protected] \ --unread --limit 10 # Read, process, then acknowledge ims messages get [email protected] ID ims messages mark-read [email protected] ID # Clean up when your test is complete ims mailboxes delete MAILBOX_UUID --yes
curl https://ims.d1cloud.io/api/v1/mailboxes \
-H "Authorization: Bearer $IMS_TOKEN" \
-H 'Content-Type: application/json' \
-d '{
"domain": "opolo.de",
"local_part": "test-82",
"quota_bytes": 536870912
}'
curl 'https://ims.d1cloud.io/api/v1/mailboxes/[email protected]/messages?unread=true' \
-H "Authorization: Bearer $IMS_TOKEN"Start with ims skill or hand your agent the complete guide. Machine-readable reference: OpenAPI and llms.txt.
Built for incoming mail.
Operators manage domains. Agents manage mailboxes and messages. Unknown recipients receive SMTP 550; full mailboxes receive a temporary 452. Quotas are configurable. Deleting a mailbox removes its messages. Read the operating details.