---
title: "POST /events/v3/send/batch"
method: POST
path: "/events/v3/send/batch"
tags: ["Batch"]
---

# POST /events/v3/send/batch

`POST /events/v3/send/batch`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/events/v3/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`

## Request body

- BatchedBehavioralEventHttpCompletionRequest
  - `inputs` BehavioralEventHttpCompletionRequest[], required
    - `email` string: Email of visitor
    - `eventName` string, required: Internal name of the event-type to trigger
    - `objectId` string: The object id that this event occurred on. Could be a contact id or a visitor id.
    - `occurredAt` string, date-time: The time when this event occurred (if any). If this isn't set, the current time will be used
    - `properties` object, required: Map of properties for the event in the format property internal name - property value
    - `utk` string: User token
    - `uuid` string

## Response `204`

No content

## Other responses

- `default`: An error occurred.

## Changes

- **2026-08-14** (v3) `b12482347df4`: 1 info
  - endpoint added
- **2026-07-13** (v3) `8d341c0a911c`: 1 breaking
  - api path removed without deprecation
- **2026-07-13** (v3) `7afd5ac6fbf1`: 1 info
  - endpoint added
- **2026-07-13** (v3) `ae745d244e14`: 1 breaking
  - api path removed without deprecation
- **2026-05-22** (v3) `9028f1ff9bf9`: 2 info
  - the security scope `analytics.behavioral_events.send` was added to the endpoint's security scheme `oauth2`
  - the security scope `behavioral-events-ingestion` was removed from the endpoint's security scheme `oauth2`

[Operation history](https://skmtc.dev/hubspot/apis/events-manage-event-definitions/changes/events/v3/send/batch/post.md)

---

[API](https://skmtc.dev/hubspot/apis/events-manage-event-definitions.md) - [All operations](https://skmtc.dev/hubspot/apis/events-manage-event-definitions/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/events-manage-event-definitions/revisions/49b86c29a335?raw)
