# Events

Events are the core signal system in Bento. They capture meaningful user actions with detailed context so you can understand behavior, build better segments, and trigger automations. Use events to power workflows and reporting with accurate, real-time data.

## Available Endpoints
| Method                                                   | Endpoint                                                           | Name                                       |
|----------------------------------------------------------|--------------------------------------------------------------------|--------------------------------------------|
|  |  | [Create Events](/events_api#create-events) |

---

## The Events Model

  
    The events model requires you to pass an event type and email. User fields, details, and the date are optional fields for recording metadata about the event or the visitor.
  
  
    ### Properties

    
      - **type** (`string`): 
        The name of the event
      
      - **email** (`string`): 
        Email of the event user
      
      - **fields** (`object`): 
        `Key` `value` array of fields for the event should not be nested
      
      - **details** (`object`): 
        `Key` `value` array of fields for the event can be nested
      
    
  


---

## Create Events {{ tag: 'POST', label: '/v1/batch/events' }}


  
    This endpoint is used to send events to your site. Events will create new users if they do not already exist in your account.

    
> This endpoint takes an array `events` that can contain 1 to 1000 events made up of the following keys.


    ### Required Attributes
    
      - **type** (`string`): 
        The name of the event
      
      - **email** (`string`): 
        Email of the event user
      
    

    ### Optional Attributes
    
      - **fields** (`object`): 
        `Key` `value` array of fields for the event should not be nested
      
      - **details** (`object`): 
        `Key` `value` array of fields for the event can be nested
      
    

  
  
    
  

<br/><br/>

  
    ### Response
    Returns the count of events recorded.