---
title: "Send an event"
method: POST
path: "/event/events"
tags: ["Custom Events"]
---

# Send an event

`POST /event/events`

Sends an event.

## Request body

- CustomEventSendRequest — Contains the properties of the custom event data to be sent.
  - `eventName` string, required — Name of the event. One of the custom event names you previously defined.
  - `occurTime` string, date-time — The time at which the event occurred, formatted in [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339). e.g., `2022-06-01T12:00:00.000Z`, if not provided, the current time will be used.
  - `objectId` string — ID of the object that the event is associated with. For events defined with `objectType` as `CONTACT`, the `objectId` should be a `contact` ID. Alternatively, you can use the `contactPhoneNumber` field to specify the contact.
  - `contactPhoneNumber` string — The phone number of the contact for events defined with `objectType` as `CONTACT`.
  - `properties` object — The properties of the custom event.

## Response `200`

Successfully sent the event.

---

[API](https://skmtc.dev/ycloud/apis/ycloud-api.md) · [All operations](https://skmtc.dev/ycloud/apis/ycloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ycloud/ycloud-api/revisions/4e13d3ca9df8/schema)