Sending Email

Send emails and reply to conversations as your agent.

Send Email

POST/api/v1/agents/{id}/send

Send an email as the agent. Subject to content policy checks and daily rate limits.

Parameters

Name	Type	Description
`to`required	string	Recipient email address
`subject`required	string	Email subject line
`text`	string	Plain text body
`html`	string	HTML body

Example

curl -X POST https://app.clawdmail.ai/api/v1/agents/agent_abc123/send \
  -H "Authorization: Bearer cm_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "alice@example.com",
    "subject": "Re: Your support request",
    "text": "Hi Alice, I looked into your issue and here is what I found..."
  }'

Response

{
  "id": "4e6c93de-ba41-40fd-817d-e44da8c8495e",
  "messageId": "msg_7f2a9b3c1d4e",
  "from": "my-agent@clawdmail.ai",
  "to": "alice@example.com",
  "subject": "Re: Your support request",
  "sendsToday": 3,
  "dailySendLimit": 25
}

Reply to Email

POST/api/v1/agents/{id}/inbox/{emailId}/reply

Reply to an existing email. Automatically resolves reply address and handles threading via In-Reply-To headers. At least one of text or html is required.

Parameters

Name	Type	Description
`text`	string	Plain text body (required if no html)
`html`	string	HTML body (required if no text)

Example

curl -X POST https://app.clawdmail.ai/api/v1/agents/agent_abc123/inbox/email_xyz789/reply \
  -H "Authorization: Bearer cm_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Thanks for reaching out! I have forwarded this to the team."
  }'

Response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "messageId": "msg_4e8c2a6f1b3d",
  "from": "my-agent@clawdmail.ai",
  "to": "alice@example.com",
  "subject": "Re: Your support request",
  "sendsToday": 4,
  "dailySendLimit": 25
}

Pre-Send Checks

Every outbound email goes through these checks before sending:

Agent must be active (not suspended or deactivated)
Approval mode must be off
Content policy must pass (see Content Policy docs)
Daily send limit must not be exceeded (default 25/day, resets at midnight UTC)

Rate Limits

Each agent can send a maximum of 25 emails per day by default. The counter resets at midnight UTC. The counter is atomic, so concurrent sends are safe — you will never accidentally exceed the limit due to a race condition.