Sign in

v1

latestOpenAPI 3.0.32026-07-2226694862.5 KB
Partner Postbacks

Update Partner Postback

Update an existing partner postback.

put/networks/pixels/{pixelId}

Path parameters

pixelIdinteger required

The partner postback (pixel) identifier.

Request body

network_offer_idinteger

Associated offer ID. Required when pixel_level is specific or global_offer. Set to 0 when pixel_level is global.

network_affiliate_idinteger

Associated affiliate ID. Required when pixel_level is specific or global. Set to 0 when pixel_level is global_offer.

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

Determines how the postback will be fired. postback fires server-to-server (S2S). html fires from an HTML tag/pixel. facebook (Meta), tiktok, snapchat, and rumble fire through their respective integrations.

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

Scope of the postback. global fires for a specific partner across all offers (set network_affiliate_id, network_offer_id to 0). specific fires for a specific offer/affiliate combination (set both IDs). global_offer fires for all affiliates on a specific offer (set network_offer_id, network_affiliate_id to 0). Not available when pixel_type is cpc.

pixel_status'active' | 'inactive' required

Postback status.

pixel_type'conversion' | 'cpc' | 'event' required

conversion fires for the base conversion action. event fires for any post-conversion events. cpc is used specifically for offers with CPC payouts and fires on every unique payable click action. When cpc is selected, pixel_level cannot be changed.

postback_urlstring

The postback URL. Required when delivery_method is postback. Supports macros like {transaction_id}. The URL requires the http:// or https:// protocol prefix.

html_codestring

HTML/iframe/image/JavaScript pixel code. Required when delivery_method is html.

descriptionstring

Optional description for this postback.

delay_msinteger

Delay in milliseconds before firing the postback. Only applicable when delivery_method is postback. Maximum 5 minutes (300000 ms).

network_offer_payout_revenue_idinteger

ID of the offer payout/revenue entry (event ID). Only relevant when pixel_type is event and pixel_level is specific or global_offer. Use 0 to fire for all events on the offer.

Response

network_pixel_idinteger

Unique partner postback (pixel) ID.

network_idinteger

Network ID.

network_affiliate_idinteger

Associated affiliate ID (0 for all affiliates).

network_offer_idinteger

Associated offer ID. Only relevant if pixel_level is specific or global_offer. Set to 0 when pixel_level is global.

network_offer_payout_revenue_idinteger

ID of the offer payout and revenue entry associated with this postback, also known as the event ID. Only relevant when pixel_type is event and pixel_level is specific or global_offer. A value of 0 selects all payout and revenue / event IDs on the offer.

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

Determines how the postback will be fired. postback fires server-to-server (S2S). html fires from an HTML tag/pixel. facebook, tiktok, snapchat, and rumble fire through their respective integrations.

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

Determines if the postback should be used for all offers (global), a specific offer/affiliate combination (specific), or all affiliates on a specific offer (global_offer).

pixel_status'active' | 'inactive'

Postback status. Can be active or inactive.

pixel_type'conversion' | 'cpc' | 'event'

conversion fires for the base conversion action. event fires for any post-conversion events. cpc is used specifically for offers with CPC payouts and fires on every unique payable click action.

postback_urlstring

The postback URL (used when delivery_method is postback). The URL requires the http:// or https:// protocol prefix.

html_codestring

HTML/iframe/image/JavaScript pixel code (when delivery_method is html).

descriptionstring

Description of this postback.

delay_msinteger

Optional delay in milliseconds that the system will wait before firing the postback. Only relevant when delivery method is postback. Maximum delay is 5 minutes (300000 milliseconds).

time_createdinteger

Unix timestamp of creation.

time_savedinteger

Unix timestamp of last update.

Example response

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