ONLINE
Bento

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

MethodEndpointName
POST/batch/eventsCreate Events

The Events Model

The events model requires you pass an event, an email of the user fields, details and the date are all optional fields to record meta data of the event or the visitor.

Properties

  • Name
    type
    Type
    string
    Description

    The name of the event

  • Name
    email
    Type
    string
    Description

    Email of the event user

  • Name
    fields
    Type
    object
    Description

    Key value array of fields for the event should not be nested

  • Name
    details
    Type
    object
    Description

    Key value array of fields for the event can be nested

POST/v1/batch/events

Create 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

  • Name
    type
    Type
    string
    Description

    The name of the event

  • Name
    email
    Type
    string
    Description

    Email of the event user

Optional Attributes

  • Name
    fields
    Type
    object
    Description

    Key value array of fields for the event should not be nested

  • Name
    details
    Type
    object
    Description

    Key value array of fields for the event can be nested



Response

Returns the count of events recorded.