---
title: "Create Postback"
method: POST
path: "/affiliates/pixels"
tags: ["Affiliate Postbacks"]
---

# Create Postback

`POST /affiliates/pixels`

## Request body

- PostbackInput
  - `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_url` string — 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_code` string — HTML or JavaScript code for the pixel. Required when delivery_method is "html".
  - `network_offer_id` integer — The offer ID this postback applies to. Required when pixel_level is "specific".
  - `delay_ms` integer — Delay in milliseconds before firing the postback. Maximum value is 300000 (5 minutes). Defaults to 0.
  - `facebook_pixel` object — Facebook pixel configuration. Required when delivery_method is "facebook".
    - `pixel_id` string — Facebook pixel ID.
    - `event_name` string — Facebook event name to fire (e.g. Purchase, Lead).
    - `access_token` string — Facebook Conversions API access token.

## Response `200`

- Postback
  - `network_pixel_id` integer — Unique identifier for the postback.
  - `network_id` integer — Network ID.
  - `network_affiliate_id` integer — Affiliate ID that owns this postback.
  - `network_offer_id` integer — Associated offer ID (0 if global).
  - `network_offer_payout_revenue_id` integer — Associated payout/revenue ID (0 if not specific).
  - `delivery_method` string — Delivery method (html, postback, facebook).
  - `pixel_level` string — Scope of the postback (global, specific).
  - `pixel_status` string — Whether the postback is active or inactive.
  - `pixel_type` string — Type of event trigger (conversion, post_conversion, cpc).
  - `postback_url` string — URL called when the postback fires.
  - `html_code` string — HTML/JavaScript pixel code.
  - `delay_ms` integer — Delay in milliseconds before firing.
  - `time_created` integer — Unix timestamp when the postback was created.
  - `time_saved` integer — Unix timestamp when the postback was last updated.
  - `facebook_pixel` object, nullable — Facebook pixel configuration.
    - `pixel_id` string
    - `event_name` string
    - `access_token` string
  - `tiktok_pixel` object, nullable — TikTok pixel configuration.
  - `snapchat_pixel` object, nullable — Snapchat pixel configuration.
  - `rumble_pixel` object, nullable — Rumble pixel configuration.
  - `relationship` object — Related entity data.
    - `affiliate` object — Affiliate that owns this postback.
      - `network_affiliate_id` integer — Affiliate ID.
      - `network_id` integer — Network ID.
      - `name` string — Affiliate name.
      - `account_status` string — Affiliate account status.
      - `network_employee_id` integer — Assigned employee ID.
      - `internal_notes` string — Internal notes.
      - `has_notifications` boolean — Whether notifications are enabled.
      - `network_traffic_source_id` integer — Traffic source ID.
      - `account_executive_id` integer — Account executive ID.
      - `adress_id` integer — Address ID. Note the field name is `adress_id` (missing "d") in the API response.
      - `default_currency_id` string — Default currency code.
      - `is_contact_address_enabled` boolean — Whether contact address is enabled.
      - `enable_media_cost_tracking_links` boolean — Whether media cost tracking links are enabled.
      - `time_created` integer — Unix timestamp when the affiliate was created.
      - `time_saved` integer — Unix timestamp when the affiliate was last saved.
      - `referrer_id` integer — Referrer affiliate ID (0 if none).
    - `offer` object — Offer associated with this postback. Only present when pixel_level is "specific".
      - `network_offer_id` integer — Offer ID.
      - `network_id` integer — Network ID.
      - `network_advertiser_id` integer — Advertiser ID.
      - `network_offer_group_id` integer — Offer group ID.
      - `name` string — Offer name.
      - `offer_status` string — Offer status.
      - `network_tracking_domain_id` integer — Tracking domain ID.
      - `visibility` string — Offer visibility (public, require_approval, private).
      - `currency_id` string — Currency code for the offer.
    - `payout_revenue` object — Payout/revenue configuration details. Present when network_offer_payout_revenue_id > 0.

## Other responses

- `400` — Bad request. Possible reasons include missing required fields, invalid delivery_method, or delay_ms exceeding 300000.

---

[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)