# 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.


> ⚠️ **Warning**
> Avoid using emojis or URL shorteners 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
| Method                                                   | Endpoint                                                           | Name                                            |
|----------------------------------------------------------|--------------------------------------------------------------------|-------------------------------------------------|
|  |  | [Create Emails](/docs/emails_api#create-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

    
      - **to** (`string`): 
        The email address of the recipient.
      
      - **from** (`string`): 
        The email address of the sender. Must be an author in your account.
      
      - **subject** (`string`): 
        The subject of the email.
      
      - **html_body** (`string`): 
        The HTML body of the email.
      
      - **transactional** (`boolean`): 
        `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!
      
      - **personalizations** (`object`): 
        `key` `value` pair custom data to be injected into the email.
      
    
  


---

## Create Emails {{ tag: 'POST', label: '/v1/batch/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.


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


    ### Required Attributes
    
      - **to** (`string`): 
        The email address of the recipient.
      
      - **from** (`string`): 
        The email address of the sender. Must be an author in your account.
      
      - **subject** (`string`): 
        The subject of the email.
      
      - **html_body** (`string`): 
        The HTML body of the email.
      
      - **transactional** (`boolean`): 
        `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
    
      - **personalizations** (`object`): 
        `key` `value` pair custom data to be injected into the email.
      
    

  
  
    
  

<br/><br/>

  
    ### Response
    Returns the count of emails queued for delivery.