Skip to main content
POST
/
api
/
emails
cURL
curl --request POST \
  --url https://api.recoupable.com/api/emails \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "to": [
    "recipient@example.com"
  ],
  "cc": [
    "cc@example.com"
  ],
  "subject": "Weekly Pulse Report",
  "text": "# Pulse Report\n\nHere's your weekly summary.",
  "html": "<h1>Pulse Report</h1><p>Here's your weekly summary.</p>",
  "headers": {},
  "chat_id": "<string>",
  "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
EOF
{
  "success": true,
  "message": "Email sent successfully from Agent by Recoup <agent@recoupable.com> to recipient@example.com.",
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Body

application/json

Email payload

​
to
string<email>[]

Recipient email address(es). Optional — when omitted, the email is sent to the authenticated account's own email address. Without a payment method on file, restricted to the account's own email; add a payment method to send to any recipient.

Minimum array length: 1
Example:
["recipient@example.com"]
​
cc
string<email>[]

Optional CC email addresses. Without a payment method on file, restricted to the account's own email; add a payment method to send to any recipient.

Example:
["cc@example.com"]
​
subject
string

Email subject line. Optional — when omitted, defaults to the first heading or line of the body, falling back to Message from Recoup if the body is empty.

Example:

"Weekly Pulse Report"

​
text
string

Plain text or Markdown body. Rendered as HTML via Markdown if no html is provided.

Example:

"# Pulse Report\n\nHere's your weekly summary."

​
html
string

Raw HTML body. Takes precedence over text when both are provided.

Example:

"<h1>Pulse Report</h1><p>Here's your weekly summary.</p>"

​
headers
object

Optional custom email headers

​
chat_id
string

Chat ID to include a chat link in the email footer. Use Create Chat to create one.

​
account_id
string<uuid>

UUID of the account to send the email for. Only applicable when the authenticated account has access to multiple accounts via organization membership. If not provided, sends for the API key's own account.

Response

Email sent successfully

​
success
boolean
required

Whether the email was sent successfully

Example:

true

​
message
string
required

Human-readable result message

Example:

"Email sent successfully from Agent by Recoup <agent@recoupable.com> to recipient@example.com."

​
id
string
required

Resend email ID

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"