Skip to main content
POST
Send emails
Every recipient is checked before anything is queued, transactional emails included. If any recipient restricted email or is on the outbound blocklist, the whole request is refused with HTTP 422 and nothing is sent; see refused sends. Send again without that recipient. A delayed email is checked again when it goes out and is not sent if the recipient was restricted or blocked in the meantime.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
from_email
string<email>
required
Pattern: ^(?:[A-Za-z0-9_'+\-]+\.)*[A-Za-z0-9_'+\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
recipients
object[]
required
delay_in_minutes
number
fallback_email_subject
string
fallback_email_sender_name
string
fallback_email_body
string

Response

Default Response

statusCode
enum<number>
required
Available options:
422
message
string
required
error
string

contact_channel_restricted when the contact restricted this channel; contact_address_blocked when the address is on the do-not-contact list for this channel.