Send an email
send_emailSends a single (transactional) email to one or more addresses. The sender must belong to a verified domain of the workspace — call get_account to see which ones. An address suppressed for a bounce, a complaint or by hand fails the entire call, with its reason. An unsubscribed address still gets an individual email (a reply, an invoice, an appointment); a newsletter or a prospecting email must carry unsubscribe_url, and is then refused to an unsubscribed address. At most 50 addresses in all, to, cc and bcc together. Every address (to, cc, bcc) counts against the plan's monthly quota: past it, the call is refused (quota_exceeded) with the figures and the reset date — do not retry before that date. The email is sent immediately: this action cannot be undone.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | Recipient, or list of recipients. | |
| from | Yes | Sending address on a verified domain. "Name <address@domain.com>" format accepted. | |
| html | No | HTML body. | |
| text | No | Plain-text body. At least one of html or text is required. | |
| verify | No | Verify recipients before sending: an address that cannot receive mail refuses the call (`undeliverable_recipient`) instead of bouncing. Recommended for prospecting. | |
| replyTo | No | Reply-to address. | |
| subject | Yes | Message subject. | |
| unsubscribe_url | No | One-click unsubscribe https address. Required for a newsletter or a prospecting email: it makes the send refused to an unsubscribed address. Leave it out for an individual email. |