Sign in
Ad Pixels

Create an ad pixel

Changed on

Add your pixel for a business whose campaigns you claimed. Whop checks the access token with the ad platform, then sends the pixel the conversions credited to your claimed campaigns for that business. Each business takes one pixel, and each pixel can serve one business.

post/ad_pixels

Request

  • Base URL: https://api.whop.com/api/v1
  • URL: https://api.whop.com/api/v1/ad_pixels
  • Auth: HTTP bearer

Headers

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

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

Request body

access_tokenstring required

An access token that can send events to the pixel on the ad platform. Whop never returns it.

account_idstring required

The business whose claimed campaigns send conversions to this pixel, prefixed biz_. You must have claimed at least one of its campaigns.

external_idstring required

The pixel's ID on the ad platform.

platform'meta' required

The ad platform the pixel belongs to.

Example request

{
  "access_token": "new-token",
  "account_id": "biz_xxxxxxxxxxxxxx",
  "external_id": "998877665544",
  "platform": "meta"
}

Response

Created

account_idstring required

The business whose claimed campaigns send conversions to this pixel, prefixed biz_.

created_atstring required

When the pixel was added, as an ISO 8601 timestamp.

error_messagestring nullable required

Why the ad platform rejected the last delivery. Null unless status is errored.

external_idstring required

The pixel's ID on the ad platform.

idstring required

Ad pixel ID, prefixed adpx_.

namestring nullable required

The pixel's name on the ad platform. Null when the ad platform returned none.

platform'meta' required

The ad platform the pixel belongs to.

status'active' | 'errored' | 'disabled' required

active receives conversions. errored stopped because the ad platform rejected the access token; update the token to resume. disabled was turned off by Whop.

updated_atstring required

When the pixel was last changed, as an ISO 8601 timestamp.

Example response

{
  "account_id": "biz_xxxxxxxxxxxxxx",
  "created_at": "2026-01-01T12:00:00.000Z",
  "external_id": "111222001",
  "id": "adpx_xxxxxxxxxxxxxx",
  "name": "Supplier pixel",
  "platform": "meta",
  "status": "active",
  "updated_at": "2026-01-01T12:00:00.000Z"
}

Changes