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

# Send a batch of event occurrences

`POST /events/v3/send/batch`

Send multiple event occurrences at once.

## Request body

- BatchedBehavioralEventHttpCompletionRequest
  - `inputs` BehavioralEventHttpCompletionRequest[], 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.

---

[API](https://skmtc.net/hubspot/apis/events-send-event-completions.md) · [All operations](https://skmtc.net/hubspot/apis/events-send-event-completions/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hubspot/events-send-event-completions/revisions/6053e5240ca1/schema)