Skip to main content
PATCH
Update an ad pixel

Authorizations

Authorization
string
header
required

A user OAuth token or a user API key. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.

Headers

Api-Version-Date
string

Pins the request to a dated API version.

Example:

"2026-10-29-8"

Path Parameters

id
string
required

Ad pixel ID, prefixed adpx_.

Body

application/json
access_token
string
required
write-only

A credential that can send events to the pixel on the ad platform: a Meta Conversions API access token, a TikTok Events API access token, or for google, the JSON key of a Google Cloud service account. The service account needs Standard access to the Google Ads account, and its project needs the Google Ads API and the Data Manager API turned on and Explorer access or higher to the Google Ads API. Use a service account made only for Whop, with no roles in its project. Whop never returns it.

Example:

"new-token"

Response

Updated

account_id
string
required

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

Example:

"biz_xxxxxxxxxxxxxx"

created_at
string
required

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

Example:

"2026-01-01T12:00:00.000Z"

error_message
string | null
required

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

Example:

null

external_id
string
required

The pixel's ID on the ad platform: the Meta pixel or dataset ID, the TikTok pixel code, or the Google Ads customer ID.

Example:

"111222001"

id
string
required

Ad pixel ID, prefixed adpx_.

Example:

"adpx_xxxxxxxxxxxxxx"

name
string | null
required

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

Example:

"Supplier pixel"

platform
enum<string>
required

The ad platform the pixel belongs to.

Available options:
meta,
tiktok,
google
Example:

"meta"

status
enum<string>
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.

Available options:
active,
errored,
disabled
Example:

"active"

updated_at
string
required

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

Example:

"2026-01-01T12:00:00.000Z"