---
title: "Send a batch of event occurrences"
method: POST
path: "/events/2026-09/send/batch"
tags: ["Batch"]
---

# Send a batch of event occurrences

`POST /events/2026-09/send/batch`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/events/2026-09/send/batch`
- Auth: OAuth 2
  - Authorization code: `https://app.hubspot.com/oauth/authorize`
  - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `analytics.behavioral_events.send`

Send multiple event occurrences at once.

## Request body

- BatchedBehavioralEventHttpCompletionRequest
  - `inputs` BehavioralEventHttpCompletionRequest[], required: An array of BehavioralEventHttpCompletionRequest objects, each representing a single behavioral event to be completed. This property is required.
    - `email` string: The visitor's email address. Used for associating the event data with a CRM record.
    - `eventName` string, required: The event's fully qualified name. This value (formatted as `pe{HubID}_{name}`) can be retrieved through the [event definitions API](https://developers.hubspot.com/docs/reference/api/analytics-and-events/custom-events/custom-event-definitions#get-%2Fevents%2Fv3%2Fevent-definitions) or in [HubSpot's UI](https://knowledge.hubspot.com/reports/create-custom-behavioral-events-with-the-code-wizard#find-internal-name).
    - `objectId` string: The ID of the record for which the event occurred (e.g., contact ID or visitor ID).
    - `occurredAt` string, date-time: The time when this event occurred. If this isn't set, the current time will be used.
    - `properties` object, required: The event properties to update. Takes the format of key-value pairs (property internal name and property value). Learn more about [HubSpot's default event properties](https://developers.hubspot.com/docs/guides/api/analytics-and-events/custom-events/custom-event-definitions#hubspot-s-default-event-properties).
    - `utk` string: The visitor's usertoken. Used for associating the event data with a CRM record.
    - `uuid` string: A unique identifier for the event occurrence. Must be unique within the event type. If not provided, HubSpot will generate a random UUID. When multiple events have the same ID within a year, the first will be accepted and all others will be rejected. Can be useful for matching data between HubSpot and other external systems.

## Response `204`

No content

## Other responses

- `default`: An error occurred.

## Changes

- **2026-09-09** (2026-09) `bc26b490c2e5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hubspot/apis/events-send-event-completions/changes/events/2026-09/send/batch/post.md)

---

[API](https://skmtc.dev/hubspot/apis/events-send-event-completions.md) - [All operations](https://skmtc.dev/hubspot/apis/events-send-event-completions/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/events-send-event-completions/revisions/6d1f594269d2?raw)