---
title: "Update Partner Postback"
method: PUT
path: "/networks/pixels/{pixelId}"
tags: ["Partner Postbacks"]
---

# Update Partner Postback

`PUT /networks/pixels/{pixelId}`

Update an existing partner postback.

## Path parameters

- `pixelId` integer, required

## Request body

- PartnerPostbackInput
  - `network_offer_id` integer — Associated offer ID. Required when `pixel_level` is `specific` or `global_offer`. Set to 0 when `pixel_level` is `global`.
  - `network_affiliate_id` integer — 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_url` string — The postback URL. Required when `delivery_method` is `postback`. Supports macros like `{transaction_id}`. The URL requires the `http://` or `https://` protocol prefix.
  - `html_code` string — HTML/iframe/image/JavaScript pixel code. Required when `delivery_method` is `html`.
  - `description` string — Optional description for this postback.
  - `delay_ms` integer — Delay in milliseconds before firing the postback. Only applicable when `delivery_method` is `postback`. Maximum 5 minutes (300000 ms).
  - `network_offer_payout_revenue_id` integer — 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.
  - `facebook_pixel` object — Meta (Facebook) pixel configuration. Required when `delivery_method` is `facebook`.
    - `network_affiliate_integration_facebook_business_id` integer — Meta Business integration ID.
    - `pixel_id` string — Meta Pixel ID.
    - `event_name` string — Meta event name. Use a standard event (e.g. Purchase, Lead, CompleteRegistration) or enable custom event name for a custom value.
    - `event_id` string — Optional Meta Event ID for deduplication. Supports macros.
    - `action_source` string — Where the conversion occurred (e.g. website, app, email, phone_call).
    - `event_source_url` string — The URL where the conversion event occurred.
    - `user_data` object[] — Meta User Data parameters for matching.
      - `field` 'email' | 'phone' | 'gender' | 'date_of_birth' | 'last_name' | 'first_name' | 'city' | 'state' | 'zipcode' | 'country_code' | 'external_id' | 'fbc' | 'fbp' | 'subscription_id' | 'fb_login_id'
      - `value` string — Value or macro (e.g. `{email}`).
    - `custom_data` object[] — Meta Custom Data parameters.
      - `field` 'value' | 'currency' | 'order_id' | 'predicted_ltv' | 'num_items' | 'status' | 'search_string'
      - `value` string — Value or macro.
  - `tiktok_pixel` object — TikTok pixel configuration. Required when `delivery_method` is `tiktok`.
    - `network_affiliate_integration_tiktok_id` integer — TikTok integration ID.
    - `pixel_code` string — TikTok Pixel Code.
    - `event_name` 'view_content' | 'click_button' | 'search' | 'add_to_wishlist' | 'add_to_cart' | 'initiate_checkout' | 'add_payment_info' | 'complete_payment' | 'place_order' | 'contact' | 'download' | 'submit_form' | 'complete_registration' | 'subscribe' — TikTok event name. Use a standard event or enable custom event name for a custom value.
    - `url` string — Page URL. Supports macros.
    - `email` string — User email. Supports macros.
    - `phone` string — User phone number. Supports macros.
    - `properties` object[] — TikTok Properties for additional event data.
      - `field` 'price' | 'quantity' | 'content_type' | 'content_id' | 'content_category' | 'content_name' | 'currency' | 'value' | 'description' | 'query' | 'status'
      - `value` string — Value or macro.
  - `snapchat_pixel` object — Snapchat pixel configuration. Required when `delivery_method` is `snapchat`.
    - `network_affiliate_integration_snapchat_id` integer — Snapchat integration ID.
    - `asset_id` string — Snapchat App/Pixel ID.
    - `event_name` string — Snapchat Event Name.
    - `event_id` string — Optional Snapchat Event ID. Supports macros.
    - `action_source` string — Where the conversion occurred (e.g. WEB, APP).
    - `event_source_url` string — Event Source URL.
    - `user_data` object[] — Snapchat User Data parameters for matching.
      - `field` 'email' | 'phone' | 'first_name' | 'last_name' | 'gender' | 'city' | 'state' | 'zipcode' | 'country_code' | 'idfv' | 'sc_cid'
      - `value` string — Value or macro.
    - `custom_data` object[] — Snapchat Custom Data parameters.
      - `field` 'value' | 'currency' | 'order_id' | 'num_items' | 'status' | 'search_string'
      - `value` string — Value or macro.
  - `rumble_pixel` object — Rumble pixel configuration. Required when `delivery_method` is `rumble`.
    - `network_affiliate_integration_rumble_id` integer — Rumble integration ID.
    - `conversion_action_id` integer — Rumble Conversion Action ID.

## Response `200`

- PartnerPostback
  - `network_pixel_id` integer — Unique partner postback (pixel) ID.
  - `network_id` integer — Network ID.
  - `network_affiliate_id` integer — Associated affiliate ID (0 for all affiliates).
  - `network_offer_id` integer — 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_id` integer — 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_url` string — The postback URL (used when delivery_method is `postback`). The URL requires the `http://` or `https://` protocol prefix.
  - `html_code` string — HTML/iframe/image/JavaScript pixel code (when delivery_method is html).
  - `description` string — Description of this postback.
  - `delay_ms` integer — 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_created` integer — Unix timestamp of creation.
  - `time_saved` integer — Unix timestamp of last update.
  - `facebook_pixel` object, nullable — Meta (Facebook) pixel configuration. Present when `delivery_method` is `facebook`.
    - `network_affiliate_integration_facebook_business_id` integer — Meta Business integration ID.
    - `pixel_id` string — Meta Pixel ID.
    - `event_name` string — Meta event name.
    - `event_id` string — Meta Event ID for deduplication.
    - `action_source` string — Where the conversion occurred.
    - `event_source_url` string — The URL where the conversion event occurred.
    - `user_data` object[]
      - `field` 'email' | 'phone' | 'gender' | 'date_of_birth' | 'last_name' | 'first_name' | 'city' | 'state' | 'zipcode' | 'country_code' | 'external_id' | 'fbc' | 'fbp' | 'subscription_id' | 'fb_login_id'
      - `value` string
    - `custom_data` object[]
      - `field` 'value' | 'currency' | 'order_id' | 'predicted_ltv' | 'num_items' | 'status' | 'search_string'
      - `value` string
  - `tiktok_pixel` object, nullable — TikTok pixel configuration. Present when `delivery_method` is `tiktok`.
    - `network_affiliate_integration_tiktok_id` integer — TikTok integration ID.
    - `pixel_code` string — TikTok Pixel Code.
    - `event_name` string — TikTok event name.
    - `url` string — Page URL.
    - `email` string — User email.
    - `phone` string — User phone number.
    - `properties` object[]
      - `field` 'price' | 'quantity' | 'content_type' | 'content_id' | 'content_category' | 'content_name' | 'currency' | 'value' | 'description' | 'query' | 'status'
      - `value` string
  - `snapchat_pixel` object, nullable — Snapchat pixel configuration. Present when `delivery_method` is `snapchat`.
    - `network_affiliate_integration_snapchat_id` integer — Snapchat integration ID.
    - `asset_id` string — Snapchat App/Pixel ID.
    - `event_name` string — Snapchat Event Name.
    - `event_id` string — Snapchat Event ID.
    - `action_source` string — Where the conversion occurred.
    - `event_source_url` string — Event Source URL.
    - `user_data` object[]
      - `field` 'email' | 'phone' | 'first_name' | 'last_name' | 'gender' | 'city' | 'state' | 'zipcode' | 'country_code' | 'idfv' | 'sc_cid'
      - `value` string
    - `custom_data` object[]
      - `field` 'value' | 'currency' | 'order_id' | 'num_items' | 'status' | 'search_string'
      - `value` string
  - `rumble_pixel` object, nullable — Rumble pixel configuration. Present when `delivery_method` is `rumble`.
    - `network_affiliate_integration_rumble_id` integer — Rumble integration ID.
    - `conversion_action_id` integer — Rumble Conversion Action ID.
    - `conversion_action_name` string — Rumble Conversion Action name.
  - `relationship` object — Related entities. Contains `offer` when `pixel_level` is `specific` or `global_offer`, and `affiliate` when `pixel_level` is `specific` or `global`.
    - `offer` object — Associated offer details. Present when `pixel_level` is `specific` or `global_offer`.
      - `network_offer_id` integer
      - `network_id` integer
      - `network_advertiser_id` integer
      - `network_offer_group_id` integer
      - `name` string
      - `offer_status` string
      - `network_tracking_domain_id` integer
      - `visibility` string
      - `currency_id` string
    - `affiliate` object — Associated affiliate details. Present when `pixel_level` is `specific` or `global`.
      - `network_affiliate_id` integer
      - `network_id` integer
      - `name` string
      - `account_status` string
      - `network_employee_id` integer
      - `internal_notes` string
      - `has_notifications` boolean
      - `network_traffic_source_id` integer
      - `account_executive_id` integer
      - `adress_id` integer — Address ID (note the field name uses a single 'd').
      - `default_currency_id` string
      - `is_contact_address_enabled` boolean
      - `enable_media_cost_tracking_links` boolean
      - `referrer_id` integer
      - `time_created` integer
      - `time_saved` integer

---

[API](https://skmtc.net/everflow/apis/everflow-network-api-tracking-domains.md) · [All operations](https://skmtc.net/everflow/apis/everflow-network-api-tracking-domains/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/everflow/everflow-network-api-tracking-domains/revisions/39242cee0e32/schema)