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

# Send a custom event occurrence

`POST /events/v3/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.

---

[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)