Bento

Emails

Emails are the simple and efficient way to craft one off messages such as welcome emails, password resets, or other crucial transactional communications. Requests are instant and queued into a priority queue. Most requests will be processed within 1-5 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 using emojis or URL shortners in your transactional emails as they may be detected by our systems as spam. In such cases, emails will be throttled to 1 email per hour to slow down any attack. Additionally, we also recommend not personalizing emails with dynamic content that a user can set (i.e first_name, last_name, etc) as this can lead to vulnerabilities where users can inject their own content into emails.

Available Endpoints

MethodEndpointName
POST/batch/emailsCreate Emails

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
    to
    Type
    string
    Description

    The email address of teh recipient.

  • Name
    from
    Type
    string
    Description

    The email address of the sender. Must be an author in your account.

  • Name
    subject
    Type
    string
    Description

    The subject of the email.

  • Name
    html_body
    Type
    string
    Description

    The HTML body of the email.

  • Name
    transactional
    Type
    boolean
    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
    personalizations
    Type
    object
    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
    to
    Type
    string
    Description

    The email address of teh recipient.

  • Name
    from
    Type
    string
    Description

    The email address of the sender. Must be an author in your account.

  • Name
    subject
    Type
    string
    Description

    The subject of the email.

  • Name
    html_body
    Type
    string
    Description

    The HTML body of the email.

  • Name
    transactional
    Type
    boolean
    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!

Optional Attributes

  • Name
    personalizations
    Type
    object
    Description

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



Response

Returns the count of emails queued for delivery.