# Cooper Email recipes

These match the scenarios on https://cooperemail.com/use-cases.

HTML: https://cooperemail.com/docs/recipes

## Give your personal agent its own address.

Plan: free

Connect Claude, ChatGPT, Cursor, or Grok Bot through MCP and create name@cooperemail.com, so the agent stops borrowing your personal mailbox.

```bash
curl -s https://cooperemail.com/api/v1/onboard \
  -H 'content-type: application/json' \
  -d '{"username":"research-bot","display_name":"Research"}'
```

## Let a browser agent finish signups.

Plan: free

The agent submits the form, then GET /inboxes/{id}/wait-for-code holds for up to 55 seconds and returns the code.

```bash
curl -s "https://cooperemail.com/api/v1/inboxes/$INBOX/wait-for-code?wait=55" \
  -H "authorization: Bearer $COOP_KEY"
```

## Approve before anything is sent.

Plan: free

Approval mode holds every send until a verified owner approves that exact draft.

```bash
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"}'
```

## Let agents email each other.

Plan: free

Two agents on different stacks need only an address each. Account search finds the thread later.

```bash
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"}'
```

## Support or hello@ inbox on your domain.

Plan: starter

The agent triages, drafts, and replies in the same thread. Signed webhooks fire on each new message.

```bash
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"}'
```

## Invoice and receipt inbox.

Plan: starter

Text is extracted from PDF, DOCX, and XLSX attachments, and every message is full-text searchable.

```bash
curl -s https://cooperemail.com/api/v1/inboxes/$INBOX/messages/$MSG/attachments/$ATT/text \
  -H "authorization: Bearer $COOP_KEY"
```

## Test inboxes per CI run.

Plan: starter

Create up to 25 at once with a TTL so they clean themselves up. Add up to 3 numbers to receive SMS codes.

```bash
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}'
```

## Vendor or quote outreach from a subdomain.

Plan: starter

Owner approval and a suppression list keep sends deliberate.

```bash
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"
```

## An inbox per customer in your SaaS.

Plan: pro

Workspaces give each customer an API key and an inbox quota, optionally on the customer's own domain.

```bash
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"}'
```

## Agent fleets.

Plan: pro

Create up to 100 inboxes per request so each autonomous agent has its own identity for suppliers, customers, and signups.

```bash
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"]}'
```

## Outbound and reply qualification.

Plan: pro

Spread sending across up to 200 domains. Bounces and complaints are suppressed automatically.

```bash
curl -s https://cooperemail.com/api/v1/domains \
  -H "authorization: Bearer $COOP_KEY" \
  -H "content-type: application/json" \
  -d '{"domain":"outreach.example.com"}'
```

## Workflow inboxes.

Plan: pro

Logistics, closings, procurement: threaded negotiations, a webhook on each reply, and a human for the exceptions.

```bash
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"}'
```