---
title: "Send a custom event occurrence"
method: POST
path: "/events/v3/send"
tags: ["Basic"]
---

# Send a custom event occurrence

`POST /events/v3/send`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/events/v3/send`
- 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 data for a single custom event occurrence.

## Request body

- BehavioralEventHttpCompletionRequest
  - `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-08-14** (v3) `6053e5240ca1`: 1 info
  - endpoint added
- **2026-07-13** (v3) `5bd25fb2700d`: 1 breaking
  - api path removed without deprecation
- **2026-05-22** (v3) `a2c31947165a`: 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`
- **2026-04-15** (v3) `50ac8d219a20`: 4 info
  - the endpoint scheme security `app_cookie` was removed from the API
  - the endpoint scheme security `hapikey` was removed from the API
  - the endpoint scheme security `internal_cookie` was removed from the API
  - the endpoint scheme security `shhkey` was removed from the API
- **2026-04-09** (v3) `83b64c234449`: 8 info
  - api operation id `post-/events/v3/send` removed and replaced with `post-/events/v3/send_send`
  - the endpoint scheme security `app_cookie` was added to the API
  - the endpoint scheme security `hapikey` was added to the API
  - the endpoint scheme security `internal_cookie` was added to the API
  - …4 more

[Operation history](https://skmtc.dev/hubspot/apis/events-send-event-completions/changes/events/v3/send/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/6ab3f9bdf2b0?raw)
