---
title: "Create Event"
method: POST
path: "/events"
tags: ["Events"]
---

# Create Event

`POST /events`

Tracks a conversion or engagement event for an account.

## Headers

- `Idempotency-Key` string

## Request body

- object — Parameters for CreateConversion
  - `account_id` string, required — The account to associate with this event.
  - `action_source` 'email' | 'website' | 'app' | 'phone_call' | 'chat' | 'physical_store' | 'system_generated' | 'business_messaging' | 'other', nullable — The channel where an event originated
  - `context` object, nullable — Tracking and attribution context.
    - `ad_campaign_id` string, nullable — Ad campaign ID.
    - `ad_id` string, nullable — Ad ID.
    - `ad_set_id` string, nullable — Ad set ID.
    - `fbc` string, nullable — Facebook click cookie (_fbc, format fb.1.{timestamp}.{fbclid}).
    - `fbclid` string, nullable — Facebook click ID.
    - `fbp` string, nullable — Facebook browser pixel ID.
    - `fingerprint` string, nullable — Client-side device fingerprint.
    - `fingerprint_confidence` number, nullable — Confidence score (0-1) for the device fingerprint.
    - `ga` string, nullable — Google Analytics client ID.
    - `gbraid` string, nullable — Google Ads gbraid click ID (iOS privacy).
    - `gclid` string, nullable — Google click ID.
    - `ig_sid` string, nullable — Instagram session ID.
    - `ip_address` string, nullable — IP address.
    - `language` string, nullable — Browser language (e.g. en-US).
    - `li_fat_id` string, nullable — LinkedIn click ID.
    - `msclkid` string, nullable — Microsoft Advertising (Bing) click ID.
    - `rdt_cid` string, nullable — Reddit click ID.
    - `sccid` string, nullable — Snapchat click ID.
    - `screen_resolution` string, nullable — Screen resolution (e.g. 1920x1080).
    - `timezone` string, nullable — IANA timezone (e.g. America/New_York).
    - `ttclid` string, nullable — TikTok click ID.
    - `ttp` string, nullable — TikTok pixel ID.
    - `twclid` string, nullable — X (Twitter) click ID.
    - `user_agent` string, nullable — Browser user agent string.
    - `utm_campaign` string, nullable — UTM campaign parameter.
    - `utm_content` string, nullable — UTM content parameter.
    - `utm_id` string, nullable — UTM ID parameter.
    - `utm_medium` string, nullable — UTM medium parameter.
    - `utm_source` string, nullable — UTM source parameter.
    - `utm_term` string, nullable — UTM term parameter.
    - `wbraid` string, nullable — Google Ads wbraid click ID (iOS privacy).
  - `currency` 'usd' | 'sgd' | 'inr' | 'aud' | 'brl' | 'cad' | 'dkk' | 'eur' | 'nok' | 'gbp' | 'sek' | 'chf' | 'hkd' | 'huf' | 'jpy' | 'mxn' | 'myr' | 'pln' | 'czk' | 'nzd' | 'aed' | 'eth' | 'ape' | 'cop' | 'ron' | 'thb' | 'bgn' | 'idr' | 'dop' | 'php' | 'try' | 'krw' | 'twd' | 'vnd' | 'pkr' | 'clp' | 'uyu' | 'ars' | 'zar' | 'dzd' | 'tnd' | 'mad' | 'kes' | 'kwd' | 'jod' | 'all' | 'xcd' | 'amd' | 'bsd' | 'bhd' | 'bob' | 'bam' | 'khr' | 'crc' | 'xof' | 'egp' | 'etb' | 'gmd' | 'ghs' | 'gtq' | 'gyd' | 'ils' | 'jmd' | 'mop' | 'mga' | 'mur' | 'mdl' | 'mnt' | 'nad' | 'ngn' | 'mkd' | 'omr' | 'pyg' | 'pen' | 'qar' | 'rwf' | 'sar' | 'rsd' | 'lkr' | 'tzs' | 'ttd' | 'uzs' | 'rub' | 'btc' | 'cny' | 'usdt' | 'kzt' | 'awg' | 'whop_usd' | 'xau', nullable — The available currencies on the platform
  - `custom_name` string, nullable — Custom event name when event_name is 'custom'. Maximum 35 chars for this value.
  - `duration` integer, nullable — For 'leave' events: milliseconds the visitor spent on the page.
  - `event_id` string, nullable — Client-provided identifier for deduplication. Generated if omitted.
  - `event_name` string, required — The type of event. Use a standard event (lead, submit_application, contact, complete_registration, schedule, view_content, add_to_cart) or pass your own name directly for a custom event.
  - `event_time` string, date-time, nullable — When the event occurred. Defaults to now.
  - `plan_id` string, nullable — The plan associated with the event.
  - `product_id` string, nullable — The product associated with the event.
  - `referrer_url` string, nullable — The referring URL.
  - `resumed` boolean, nullable — For 'page' events: true when the page was restored from the back/forward cache.
  - `source` string, nullable — For 'identify' events: where the identity was captured (url, form, manual, iframe).
  - `title` string, nullable — For 'page' events: the document title.
  - `url` string, nullable — The URL where the event occurred.
  - `user` object, nullable — User identity and profile data.
    - `anonymous_id` string, nullable — An anonymous identifier for the user.
    - `birthdate` string, nullable — Date of birth (YYYY-MM-DD).
    - `city` string, nullable — City.
    - `country` string, nullable — Country.
    - `email` string, nullable — Email address.
    - `external_id` string, nullable — An external identifier for the user.
    - `first_name` string, nullable — First name.
    - `gender` 'male' | 'female', nullable — Gender
    - `last_name` string, nullable — Last name.
    - `linked_anonymous_id` string, nullable — A second anonymous identifier to link to this user (e.g. captured across an iframe boundary).
    - `linked_wuid` string, nullable — A wuid from a linked frame, captured across an iframe boundary.
    - `member_id` string, nullable — The Whop member ID.
    - `membership_id` string, nullable — The Whop membership ID.
    - `name` string, nullable — Full display name.
    - `phone` string, nullable — Phone number.
    - `postal_code` string, nullable — Postal code.
    - `state` string, nullable — State or region.
    - `user_id` string, nullable — The Whop user ID.
    - `username` string, nullable — Username.
  - `value` number, nullable — Monetary value associated with the event.

## Response `200`

event created

- object
  - `id` string, required

---

[API](https://skmtc.net/whop/apis/whop-api.md) · [All operations](https://skmtc.net/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whop/whop-api/versions/db0883548bc5/schema)