---
title: "Create event (legacy)"
method: POST
path: "/v3/events"
tags: ["Events"]
---

# Create event (legacy)

`POST /v3/events`

## Request body

- CreateEventDto
  - `customerId` string, required — The ID of the customer
  - `datetime` string, date-time, required — The date and time of the event
  - `eventTypeId` string, required — The type of event
  - `value` string, required — The value of the event, usually a number
  - `differentiator` string — The differentiator of the event
  - `metadata` object, required — event metadata
  - `invoiceGroup` string — The invoice group for split invoicing

## Response `201`

The Event

- CreatedEventsDto
  - `customerId` string, required — The ID of the customer
  - `datetime` string, date-time, required — The date and time of the event
  - `eventTypeId` string, required — The type of event
  - `value` string, required — The value of the event, usually a number
  - `differentiator` string — The differentiator of the event
  - `metadata` object, required — event metadata
  - `invoiceGroup` string — The invoice group for split invoicing
  - `id` string, required — The id of the event

## Other responses

- `400` — Event already exists

---

[API](https://skmtc.net/tabsplatform/apis/tabs-external-api.md) · [All operations](https://skmtc.net/tabsplatform/apis/tabs-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tabsplatform/tabs-external-api/revisions/7e8885517814/schema)