Emails

Use this API to send one-off messages such as welcome emails, password resets, and order confirmations. Requests are accepted immediately and queued into a priority delivery queue. Most requests are processed within 30 seconds.

This endpoint is throttled to send at a rate of 60 emails per minute regardless of how many emails you queue. For most use cases, this is more than enough and protects you from attacks/abuse but if you'd like to increase this limit, please reach out to support.

Avoid emojis and URL shorteners in transactional emails. Our systems may flag them as spam and throttle delivery to 1 email per hour. We also recommend not personalizing emails with user-set values (first_name, last_name, etc). Users can inject their own content into your emails through these fields.

Available Endpoints

MethodEndpoint

POST

/batch/emails

Create Emails

Queue transactional emails for priority delivery.

The Email Model

The email model resembles a standard email but includes additional flags and custom data fields for merging into the provided HTML.

Properties

Name
tostring
Description
The email address of the recipient.
Name
fromstring
Description
The email address of the sender. Must be an author in your account.
Name
subjectstring
Description
The subject of the email.
Name
html_bodystring
Description
The HTML body of the email.
Name
transactionalboolean
Description
true or false flag if the email is transactional or not. Defaults to false. When marked as true, the email will be sent even if the user has unsubscribed. USE WITH CAUTION!
Name
personalizationsobject
Description
key value pair custom data to be injected into the email.

POST/v1/batch/emails

Create Emails

Requests are instant and queued into a priority queue. Most requests will be processed within 30 seconds.

This endpoint takes an array emails that can contain 1 to 60 emails made up of the following keys.

Bento does not support file attachments in emails. Please use links to attachments instead for maximum deliverability.

Required Attributes

Name
tostring
Description
The email address of the recipient.
Name
fromstring
Description
The email address of the sender. Must be an author in your account.
Name
subjectstring
Description
The subject of the email.
Name
html_bodystring
Description
The HTML body of the email.
Name
transactionalboolean
Description
Set true to send the email even if the user has unsubscribed. Defaults to false. Use with caution.

Optional Attributes

Name
personalizationsobject
Description
key value pair custom data to be injected into the email.

Response

Returns the count of emails queued for delivery.

Name
resultsinteger
Description
Number of emails accepted and queued for delivery.