Sign in

v8

OpenAPI 3.1.02026-08-033623795.0 MB
Events

Validate Pixel

Checks whether the Whop pixel is installed for an account. Recent pixel events count as proof on their own, so an account that has sent data lately comes back installed without a url. Pass a url and events from that page settle it; conversion events are also read across the hostname because they commonly fire on a later confirmation page. If the requested page hasn't sent any events lately, it is fetched and read for the pixel and conversion events wired on it. installed is only true when the pixel was actually seen — in the account's events or in the page.

post/events/validate_pixel

Headers

Idempotency-Keystring
Example:d9105228-4a08-46b1-8b91-42fed586d383

A unique key that makes this request safe to retry. See Idempotent requests.

Request body

account_idstring

Account to check. Defaults to the authenticated account.

urlstring

A page to read for the pixel, e.g. an ad destination. Omit it to check the account from its events alone.

Response

pixel validated

firing_data_okboolean required

False when the event lookup failed, meaning host_events and last_seen_days are incomplete.

host_eventsstring[] required
installedboolean required

True when the account has sent events recently, the pixel is present in the page at url, or url is hosted on Whop.

last_fired_daysobject required

Event name to whole days since that event last fired, e.g. { "lead": 3 }. Carries events that fired too long ago to count as installed, so you can prompt to re-check rather than report them missing.

last_seen_daysnumber nullable required

Days since the pixel last sent an event, within a 30-day window. null when it hasn't sent one in that window — which includes a pixel installed moments ago.

native_trackingboolean required

True when url is hosted on Whop, so no pixel snippet is required.

page_eventsstring[] required
reachableboolean nullable required

Whether the page could be loaded. null when the request included no URL, and true when events settled the answer without a fetch.

urlstring nullable required

The URL that was checked, after normalization. null when the request didn't include one.