Recipes
The same jobs as the use-case page, as calls.
Each recipe matches a card on /use-cases. Markdown: /docs/recipes.md.
free
Give your personal agent its own address.
Connect Claude, ChatGPT, Cursor, or Grok Bot through MCP and create name@cooperemail.com, so the agent stops borrowing your personal mailbox.
curl -s https://cooperemail.com/api/v1/onboard \
-H 'content-type: application/json' \
-d '{"username":"research-bot","display_name":"Research"}'free
Let a browser agent finish signups.
The agent submits the form, then GET /inboxes/{id}/wait-for-code holds for up to 55 seconds and returns the code.
curl -s "https://cooperemail.com/api/v1/inboxes/$INBOX/wait-for-code?wait=55" \
-H "authorization: Bearer $COOP_KEY"free
Approve before anything is sent.
Approval mode holds every send until a verified owner approves that exact draft.
curl -s -X PATCH https://cooperemail.com/api/v1/inboxes/$INBOX \
-H "authorization: Bearer $COOP_KEY" \
-H "content-type: application/json" \
-d '{"send_mode":"approval"}'free
Let agents email each other.
Two agents on different stacks need only an address each. Account search finds the thread later.
curl -s https://cooperemail.com/api/v1/inboxes/$INBOX/messages \
-H "authorization: Bearer $COOP_KEY" \
-H "content-type: application/json" \
-d '{"to":["other-agent@cooperemail.com"],"subject":"Handoff","text":"The receipt is in.","client_id":"agent-to-agent-1"}'starter
Support or hello@ inbox on your domain.
The agent triages, drafts, and replies in the same thread. Signed webhooks fire on each new message.
curl -s https://cooperemail.com/api/v1/domains \
-H "authorization: Bearer $COOP_KEY" \
-H "content-type: application/json" \
-d '{"domain":"agents.example.com"}'
curl -s https://cooperemail.com/api/v1/inboxes \
-H "authorization: Bearer $COOP_KEY" \
-H "content-type: application/json" \
-d '{"username":"support","domain":"agents.example.com"}'starter
Invoice and receipt inbox.
Text is extracted from PDF, DOCX, and XLSX attachments, and every message is full-text searchable.
curl -s https://cooperemail.com/api/v1/inboxes/$INBOX/messages/$MSG/attachments/$ATT/text \
-H "authorization: Bearer $COOP_KEY"starter
Test inboxes per CI run.
Create up to 25 at once with a TTL so they clean themselves up. Add up to 3 numbers to receive SMS codes.
curl -s https://cooperemail.com/api/v1/inboxes/batch \
-H "authorization: Bearer $COOP_KEY" \
-H "content-type: application/json" \
-d '{"count":3,"prefix":"ci","labels":["ci"],"ttl_hours":24}'starter
Vendor or quote outreach from a subdomain.
Owner approval and a suppression list keep sends deliberate.
curl -s -X PATCH https://cooperemail.com/api/v1/inboxes/$INBOX \
-H "authorization: Bearer $COOP_KEY" \
-H "content-type: application/json" \
-d '{"send_mode":"approval"}'
curl -s https://cooperemail.com/api/v1/suppressions \
-H "authorization: Bearer $COOP_KEY"pro
An inbox per customer in your SaaS.
Workspaces give each customer an API key and an inbox quota, optionally on the customer's own domain.
curl -s https://cooperemail.com/api/v1/workspaces \
-H "authorization: Bearer $COOP_KEY" \
-H "content-type: application/json" \
-d '{"name":"customer-acme","inbox_quota":5,"client_id":"workspace-acme"}'pro
Agent fleets.
Create up to 100 inboxes per request so each autonomous agent has its own identity for suppliers, customers, and signups.
curl -s https://cooperemail.com/api/v1/inboxes/batch \
-H "authorization: Bearer $COOP_KEY" \
-H "content-type: application/json" \
-d '{"count":10,"prefix":"fleet","labels":["fleet"]}'pro
Outbound and reply qualification.
Spread sending across up to 200 domains. Bounces and complaints are suppressed automatically.
curl -s https://cooperemail.com/api/v1/domains \
-H "authorization: Bearer $COOP_KEY" \
-H "content-type: application/json" \
-d '{"domain":"outreach.example.com"}'pro
Workflow inboxes.
Logistics, closings, procurement: threaded negotiations, a webhook on each reply, and a human for the exceptions.
curl -s https://cooperemail.com/api/v1/webhooks \
-H "authorization: Bearer $COOP_KEY" \
-H "content-type: application/json" \
-d '{"url":"https://example.com/hooks/cooper","events":["message.received"],"client_id":"workflow-1"}'