> ## Documentation Index > Fetch the complete documentation index at: https://developers.everflow.io/llms.txt > Use this file to discover all available pages before exploring further. # Update Postback Updates an existing postback. This is a full object replacement — all fields must be provided, not just the ones being changed. The postback must belong to the authenticated affiliate. ## OpenAPI ````yaml openapi/affiliate-postbacks.yaml put /affiliates/pixels/{pixelId} openapi: 3.0.3 info: title: Everflow Affiliate API - Postbacks description: > Postback management endpoints for the Everflow Affiliate API. Affiliates can create, update, search, and list their conversion and event postbacks. **Terminology note:** the API uses **`pixel`** for the same entity the Everflow platform UI calls a **postback** — `pixel_id` (API) and `postback_id` (UI) refer to the same record. URL paths use `/pixels/...`; the platform's edit screens live at `/affiliates/postbacks/{id}/edit`. For postback concepts, see the [Postbacks guide](https://helpdesk.everflow.io/customer/introduction-to-partner-advertiser-postbacks). version: 1.0.0 servers: - description: Production Server url: https://api.eflow.team/v1 security: [] tags: - name: Affiliate Postbacks description: Endpoints for managing affiliate postbacks (pixels). paths: /affiliates/pixels/{pixelId}: put: tags: - Affiliate Postbacks summary: Update Postback parameters: - name: pixelId in: path required: true description: The numeric ID of the postback to update. schema: type: integer requestBody: required: true content: application/json: example: delivery_method: postback pixel_level: global pixel_status: active pixel_type: conversion postback_url: >- https://example.com/postback?tid={transaction_id}&amount={revenue} schema: $ref: '#/components/schemas/PostbackInput' responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/Postback' '400': description: Bad request due to invalid input. '404': description: >- Postback not found or does not belong to the authenticated affiliate. security: - API Key: [] components: schemas: PostbackInput: type: object required: - delivery_method - pixel_level - pixel_status - pixel_type properties: delivery_method: type: string enum: - html - postback - facebook description: > 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: type: string enum: - global - specific description: > Scope of the postback. "global" fires for all offers, "specific" fires only for the offer specified by network_offer_id. pixel_status: type: string enum: - active - inactive description: Whether the postback is active or inactive. pixel_type: type: string enum: - conversion - post_conversion - cpc description: > Type of event that triggers the postback. "conversion" fires on conversions, "post_conversion" fires on post-conversion events, "cpc" fires on clicks. postback_url: type: string description: > 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: type: string description: > HTML or JavaScript code for the pixel. Required when delivery_method is "html". network_offer_id: type: integer description: > The offer ID this postback applies to. Required when pixel_level is "specific". delay_ms: type: integer description: > Delay in milliseconds before firing the postback. Maximum value is 300000 (5 minutes). Defaults to 0. maximum: 300000 default: 0 facebook_pixel: type: object description: > Facebook pixel configuration. Required when delivery_method is "facebook". properties: pixel_id: type: string description: Facebook pixel ID. event_name: type: string description: Facebook event name to fire (e.g. Purchase, Lead). access_token: type: string description: Facebook Conversions API access token. Postback: type: object properties: network_pixel_id: type: integer description: Unique identifier for the postback. network_id: type: integer description: Network ID. network_affiliate_id: type: integer description: Affiliate ID that owns this postback. network_offer_id: type: integer description: Associated offer ID (0 if global). network_offer_payout_revenue_id: type: integer description: Associated payout/revenue ID (0 if not specific). delivery_method: type: string description: Delivery method (html, postback, facebook). pixel_level: type: string description: Scope of the postback (global, specific). pixel_status: type: string description: Whether the postback is active or inactive. pixel_type: type: string description: Type of event trigger (conversion, post_conversion, cpc). postback_url: type: string description: URL called when the postback fires. html_code: type: string description: HTML/JavaScript pixel code. delay_ms: type: integer description: Delay in milliseconds before firing. time_created: type: integer example: 1734455015 description: Unix timestamp when the postback was created. time_saved: type: integer example: 1734455015 description: Unix timestamp when the postback was last updated. facebook_pixel: type: object nullable: true description: Facebook pixel configuration. properties: pixel_id: type: string event_name: type: string access_token: type: string tiktok_pixel: type: object nullable: true description: TikTok pixel configuration. snapchat_pixel: type: object nullable: true description: Snapchat pixel configuration. rumble_pixel: type: object nullable: true description: Rumble pixel configuration. relationship: type: object description: Related entity data. properties: affiliate: type: object description: Affiliate that owns this postback. properties: network_affiliate_id: type: integer description: Affiliate ID. network_id: type: integer description: Network ID. name: type: string description: Affiliate name. account_status: type: string description: Affiliate account status. network_employee_id: type: integer description: Assigned employee ID. internal_notes: type: string description: Internal notes. has_notifications: type: boolean description: Whether notifications are enabled. network_traffic_source_id: type: integer description: Traffic source ID. account_executive_id: type: integer description: Account executive ID. adress_id: type: integer description: >- Address ID. Note the field name is `adress_id` (missing "d") in the API response. default_currency_id: type: string description: Default currency code. is_contact_address_enabled: type: boolean description: Whether contact address is enabled. enable_media_cost_tracking_links: type: boolean description: Whether media cost tracking links are enabled. time_created: type: integer example: 1734455015 description: Unix timestamp when the affiliate was created. time_saved: type: integer example: 1734455015 description: Unix timestamp when the affiliate was last saved. referrer_id: type: integer description: Referrer affiliate ID (0 if none). offer: type: object description: > Offer associated with this postback. Only present when pixel_level is "specific". properties: network_offer_id: type: integer description: Offer ID. network_id: type: integer description: Network ID. network_advertiser_id: type: integer description: Advertiser ID. network_offer_group_id: type: integer description: Offer group ID. name: type: string description: Offer name. offer_status: type: string description: Offer status. network_tracking_domain_id: type: integer description: Tracking domain ID. visibility: type: string description: Offer visibility (public, require_approval, private). currency_id: type: string description: Currency code for the offer. payout_revenue: type: object description: > Payout/revenue configuration details. Present when network_offer_payout_revenue_id > 0. securitySchemes: API Key: description: > The affiliate's API key generated from the Affiliate Portal. Uses the X-Eflow-Api-Key header. in: header name: X-Eflow-Api-Key type: apiKey ````