Skip to main content
GET
Retrieve an ad pixel

Autorisaties

Authorization
string
header
vereist

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.

Scopes

ad_pixel:manage

Headers

Api-Version-Date
string

Pins the request to a dated API version.

Voorbeeld:

"2026-11-17"

Padparameters

id
string
vereist

Ad pixel ID, prefixed adpx_.

Respons

Ad pixel

account
object
vereist

The business whose claimed campaigns send conversions to this pixel, with its name and logo.

account_id
string
vereist

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

Voorbeeld:

"biz_xxxxxxxxxxxxxx"

created_at
string
vereist

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

Voorbeeld:

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

error_message
string | null
vereist

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

Voorbeeld:

null

external_id
string
vereist

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

Voorbeeld:

"111222001"

id
string
vereist

Ad pixel ID, prefixed adpx_.

Voorbeeld:

"adpx_xxxxxxxxxxxxxx"

name
string | null
vereist

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

Voorbeeld:

"Supplier pixel"

platform
enum<string>
vereist

The ad platform the pixel belongs to.

Beschikbare opties:
meta,
tiktok,
google,
thrad
Voorbeeld:

"meta"

status
enum<string>
vereist

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

Beschikbare opties:
active,
errored,
disabled
Voorbeeld:

"active"

updated_at
string
vereist

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

Voorbeeld:

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