---
title: "Create an event"
method: POST
path: "/tracker/events"
tags: ["Tracker events"]
---

# Create an event

`POST /tracker/events`

Track a custom event for a subscriber. Supplements the JavaScript tracker.

## Request body

- object
  - `event` object, required — Event details.
    - `email` string, required — Subscriber's email address. The subscriber must already exist in your contact list. Maximum length is **150 characters** — longer values are rejected with a `422` error, not truncated.
    - `category` string — Event category (e.g. `"shopping"`, `"engagement"`, `"support"`). Maximum length is **255 bytes**; longer values are truncated.
    - `action` string — Event action (e.g. `"product_viewed"`, `"form_submitted"`, `"review_left"`). Maximum length is **255 bytes**; longer values are truncated.
    - `label` string — Event label — a human-readable name or identifier (e.g. a product name, page title). Maximum length is **255 bytes**; longer values are truncated.
    - `property` string — Event property — a custom key or identifier (e.g. a product SKU, category slug). Maximum length is **300 bytes**; longer values are truncated.
    - `value` union — Event value. Can be a plain string, a JSON-encoded string, or a JSON object/array (objects and arrays will be JSON-encoded automatically on our side). Maximum length is **20,000 characters** (after JSON encoding, if applicable) — longer values are rejected with a `422` error, not truncated.
      - string
      - object
      - unknown[]
        - unknown

## Response `200`

OK

- object
  - `id` integer
  - `email` string
  - `category` string
  - `action` string
  - `label` string
  - `property` string
  - `value` string

---

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