Sign in

v1

latestOpenAPI 3.0.32026-07-2226694862.5 KB
Affiliate Postbacks

Update Postback

put/affiliates/pixels/{pixelId}

Path parameters

pixelIdinteger required

The numeric ID of the postback to update.

Request body

delivery_method'html' | 'postback' | 'facebook' | 'tiktok' | 'snapchat' | 'rumble' required

How the postback is delivered. Use "postback" for server-to-server URL calls, "html" for HTML/JavaScript pixel code, or "facebook" for Facebook pixel integration.

pixel_level'global' | 'specific' | 'global_offer' required

Scope of the postback. "global" fires for all offers, "specific" fires only for the offer specified by network_offer_id.

pixel_status'active' | 'inactive' required

Whether the postback is active or inactive.

pixel_type'conversion' | 'post_conversion' | 'cpc' required

Type of event that triggers the postback. "conversion" fires on conversions, "post_conversion" fires on post-conversion events, "cpc" fires on clicks.

postback_urlstring

The URL to call when the postback fires. Supports macros like {transaction_id}, {revenue}, {offer_id}, {sub1}–{sub10}. Required when delivery_method is "postback".

html_codestring

HTML or JavaScript code for the pixel. Required when delivery_method is "html".

network_offer_idinteger

The offer ID this postback applies to. Required when pixel_level is "specific".

delay_msinteger

Delay in milliseconds before firing the postback. Maximum value is 300000 (5 minutes). Defaults to 0.

Response

network_pixel_idinteger

Unique identifier for the postback.

network_idinteger

Network ID.

network_affiliate_idinteger

Affiliate ID that owns this postback.

network_offer_idinteger

Associated offer ID (0 if global).

network_offer_payout_revenue_idinteger

Associated payout/revenue ID (0 if not specific).

delivery_methodstring

Delivery method (html, postback, facebook).

pixel_levelstring

Scope of the postback (global, specific).

pixel_statusstring

Whether the postback is active or inactive.

pixel_typestring

Type of event trigger (conversion, post_conversion, cpc).

postback_urlstring

URL called when the postback fires.

html_codestring

HTML/JavaScript pixel code.

delay_msinteger

Delay in milliseconds before firing.

time_createdinteger

Unix timestamp when the postback was created.

time_savedinteger

Unix timestamp when the postback was last updated.

tiktok_pixelobject nullable

TikTok pixel configuration.

snapchat_pixelobject nullable

Snapchat pixel configuration.

rumble_pixelobject nullable

Rumble pixel configuration.

Example response

{
  "time_created": 1734455015,
  "time_saved": 1734455015,
  "relationship": {
    "affiliate": {
      "time_created": 1734455015,
      "time_saved": 1734455015
    }
  }
}