---
title: "Send event data (single)"
method: POST
path: "/integrators/timeline/2026-09/events"
tags: ["Advanced"]
---

# Send event data (single)

`POST /integrators/timeline/2026-09/events`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/integrators/timeline/2026-09/events`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.contacts.highly_sensitive.write.v2`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.contacts.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.contacts.sensitive.write.v2`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.schemas.contacts.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.companies.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.companies.sensitive.write.v2`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.companies.highly_sensitive.write.v2`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.schemas.companies.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.schemas.deals.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.deals.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.deals.sensitive.write.v2`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.deals.highly_sensitive.write.v2`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `tickets.sensitive.v2`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `tickets.highly_sensitive.v2`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.tickets.highly_sensitive.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.tickets.sensitive.write`

Send a single instance of event data to a specified event type.

## Request body

- AppEventOccurrence
  - `domain` string: The domain associated with the event occurrence, represented as a string.
  - `email` string: The email address associated with the event occurrence, represented as a string.
  - `eventTypeName` string, required: The name of the event type, represented as a string.
  - `extraData` object: An object containing additional data related to the event occurrence.
  - `id` string, required: The unique identifier for this event occurrence, represented as a string.
  - `objectId` string: The unique identifier of the object related to the event, represented as a string.
  - `objectTypeFullyQualifiedName` string: The fully qualified name of the object type associated with the event, represented as a string.
  - `properties` object, required: A map of custom property names to their values, represented as an object with string values.
  - `timelineIFrame` TimelineEventIFrame
    - `headerLabel` string, required: The label of the modal window that displays the iframe contents.
    - `height` integer, required: The height of the modal window in pixels.
    - `linkLabel` string, required: The text displaying the link that will display the iframe.
    - `url` string, required: The URI of the iframe contents.
    - `width` integer, required: The width of the modal window in pixels.
  - `timestamp` string, date-time: The date and time when the event occurred, represented in ISO 8601 format.
  - `utk` string: The user token key (utk) associated with the event, represented as a string.

## Response `200`

App Event Occurrence was accepted and persisted successfully. Mirrored to UnifiedEvents async.

## Other responses

- `201`: successful operation
- `400`: The occurrence has a validation error that prevented us from accepting it for persistence. The response body will contain details about the validation error. Occurrence insert request rejected.
- `409`: An occurrence for this event type and occurrence ID already exists. Occurrences are immutable. Occurrence insert request rejected.
- `default`: An error occurred.

## Changes

- **2026-10-10** (2026-09) `432dbe0bb045`: 2 info
  - the security scope `crm.objects.contacts.highly_sensitive.write.v2` was added to the endpoint's security scheme `oauth2`
  - the security scope `timeline-write` was removed from the endpoint's security scheme `oauth2`
- **2026-09-09** (2026-09) `52b722be726a`: 2 info
  - the security scope `crm.objects.contacts.highly_sensitive.write.v2` was added to the endpoint's security scheme `oauth2`
  - the security scope `timeline-write` was removed from the endpoint's security scheme `oauth2`
- **2026-09-08** (2026-09) `b8a492d17795`: 2 info
  - the security scope `crm.objects.contacts.highly_sensitive.write.v2` was added to the endpoint's security scheme `oauth2`
  - the security scope `timeline` was removed from the endpoint's security scheme `oauth2`

[Operation history](https://skmtc.dev/hubspot/apis/crm-timeline/changes/integrators/timeline/2026-09/events/post.md)

---

[API](https://skmtc.dev/hubspot/apis/crm-timeline.md) - [All operations](https://skmtc.dev/hubspot/apis/crm-timeline/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/crm-timeline/revisions/432dbe0bb045?raw)