Postbacks

Operations for postbacks

Find All

GET /v1/networks/pixels

Filters

This endpoint supports basic filtering. Refer to API filters page for usage.

Value Description
network_offer_id Filter based on the offer id
network_affiliate_id Filter based on the affiliate id
network_offer_payout_revenue_id Filter based on the offer payout & revenue id
pixel_status Filter based on the pixel status
pixel_type Filter based on the pixel type
delivery_method Filter based on the delivery method
time_created Filter based on the creation time
time_saved Filter based on the last update time

cURL
curl --request GET 'https://api.eflow.team/v1/networks/pixels' \
--header 'X-Eflow-API-Key: <INSERT API KEY>'
Response
{
  "pixels": [
    {
      "network_pixel_id": 1,
      "network_id": 1,
      "network_affiliate_id": 14,
      "network_offer_id": 0,
      "network_offer_payout_revenue_id": 0,
      "delivery_method": "postback",
      "pixel_level": "global",
      "pixel_status": "active",
      "pixel_type": "conversion",
      "postback_url": "https://testpostback.com",
      "html_code": "",
      "description": "Your postback",
      "relationship": {
        "affiliate": {
          "network_affiliate_id": 14,
          "network_id": 1,
          "name": "Affiliate Example",
          "account_status": "active",
          "network_employee_id": 2,
          "internal_notes": "",
          "has_notifications": false,
          "network_traffic_source_id": 0,
          "account_executive_id": 0,
          "adress_id": 0,
          "default_currency_id": "USD",
          "is_contact_address_enabled": false,
          "enable_media_cost_tracking_links": true,
          "time_created": 1594391076,
          "time_saved": 1594391076,
          "referrer_id": 0
        }
      },
      "facebook_pixel": null
    },
    {
      "network_pixel_id": 2,
      "network_id": 1,
      "network_affiliate_id": 0,
      "network_offer_id": 1,
      "network_offer_payout_revenue_id": 0,
      "delivery_method": "postback",
      "pixel_level": "global_offer",
      "pixel_status": "inactive",
      "pixel_type": "post_conversion",
      "postback_url": "http://test2.com{sub2}{sub1}",
      "html_code": "",
      "description": "asas",
      "time_created": 1594662335,
      "time_saved": 1594662335,
      "relationship": {
        "offer": {
          "network_offer_id": 1,
          "network_id": 1,
          "network_advertiser_id": 13,
          "network_offer_group_id": 3,
          "name": "Offer Example",
          "offer_status": "active",
          "network_tracking_domain_id": 1,
          "visibility": "public",
          "currency_id": "USD"
        }
      },
      "facebook_pixel": null
    }
  ]
}

Find By ID

GET /v1/networks/pixels/:pixelId

Path Parameters

Parameter Description
pixelId The ID of the postback you want to fetch

cURL
curl --request GET 'https://api.eflow.team/v1/networks/pixels/1' \
--header 'X-Eflow-API-Key: <INSERT API KEY>'
Response
{
  "network_pixel_id": 1,
  "network_id": 1,
  "network_affiliate_id": 14,
  "network_offer_id": 0,
  "network_offer_payout_revenue_id": 0,
  "delivery_method": "postback",
  "pixel_level": "global",
  "pixel_status": "active",
  "pixel_type": "conversion",
  "postback_url": "https://postbacktest.com",
  "html_code": "",
  "description": "your postback",
  "relationship": {
    "affiliate": {
      "network_affiliate_id": 14,
      "network_id": 1,
      "name": "Affiliate Example",
      "account_status": "active",
      "network_employee_id": 2,
      "internal_notes": "",
      "has_notifications": false,
      "network_traffic_source_id": 0,
      "account_executive_id": 0,
      "adress_id": 0,
      "default_currency_id": "USD",
      "is_contact_address_enabled": false,
      "enable_media_cost_tracking_links": true,
      "time_created": 1594391076,
      "time_saved": 1594391076,
      "referrer_id": 0
    }
  },
  "facebook_pixel": null
}

Find (Advanced)

POST /v1/networks/pixelstable

Paging

This endpoint supports paging. Refer to our User Guide for usage.

This endpoint supports query filters.

search_terms object array
search_type string

The name of the field used for search. Can be one of the following : offer, affiliate, payload, pixel_id, pixel_type, status and description. Note that when using offer or affiliate, both the name and the ID will be searched.

value string

The value to search.

cURL
curl --request POST 'https://api.eflow.team/v1/networks/pixelstable' \
--header 'X-Eflow-API-Key: <INSERT API KEY>' \
--header 'Content-Type: application/json' \
--data '<INSERT PAYLOAD>'
Request

Here’s an example of what a payload could look like :

{
    "search_terms":
    [
        {
            "search_type": "affiliate",
            "value": "AffiliateName"
        },
        {
            "search_type": "pixel_type",
            "value": "post_conversion"
        }
    ]
}

Response

{
  "pixels": [
    {
      "network_pixel_id": 20,
      "network_id": 1,
      "network_offer_payout_revenue_id": 0,
      "delivery_method": "html",
      "pixel_level": "specific",
      "pixel_status": "active",
      "pixel_type": "post_conversion",
      "postback_url": "",
      "html_code": "<div>pixel content</div>",
      "network_affiliate_id": 22,
      "network_affiliate_name": "Affiliate Name",
      "network_offer_id": 40,
      "network_offer_name": "Offer Name",
      "description": "",
      "time_created": 1496184631,
      "time_saved": 1498173406,
      "relationship": {}
    },
    {
      "network_pixel_id": 112,
      "network_id": 1,
      "network_offer_payout_revenue_id": 0,
      "delivery_method": "postback",
      "pixel_level": "global_offer",
      "pixel_status": "active",
      "pixel_type": "conversion",
      "postback_url": "https://postbackdomain.com/?offer_id={offer_id}&transaction_id={transaction_id}&google_aid={google_aid}&idfa={idfa}",
      "html_code": "",
      "network_affiliate_id": 0,
      "network_affiliate_name": "",
      "network_offer_id": 81,
      "network_offer_name": "Other Offer Name",
      "description": "",
      "time_created": 1506462264,
      "time_saved": 1506462264,
      "relationship": {}
    }
  ],
  "paging": {
    "page": 1,
    "page_size": 50,
    "total_count": 2
  }
}


Create

POST /v1/networks/pixels

network_affiliate_id int

ID of the affiliate related to the postback.

network_offer_id int

ID of the offer related to the postback.

network_offer_payout_revenue_id int

ID of the offer payout and revenue related to the postback.

delivery_method string

Select whether the postback will be fired from an HTML tag/pixel, or via an S2S (Server to Server) Postback. Can be html, postback or facebook.

pixel_level string

Determines if the postback should be used for all offers, or only one selected offer. Can either be global, specific or global_offer.

pixel_status string

Status of the postback. Can either be active or inactive.

pixel_type string

Determines type of postback. Conversion is fired for the based CV action and Event is for any post-conversion events. CPC is used specifically for individual offers that have CPC payouts, and fires on every unique payable click action. It can be a conversion, post_conversion or cpc.

postback_url string

Url of the postback. Note that the URL requires http(s)://

html_code string

HTML code of the postback.

description string

Optional description.

facebook_pixel object
network_affiliate_integration_facebook_business_id int

ID of the affiliate integration facebook business.

pixel_id string

ID of the postback

event_name string

Name of the event.

user_data object array
field string

Date type of the facebook user. Can be email, phone, gender, date_of_birth, last_name, first_name, city, state, zipcode, country_code, external_id, fbc, fbp, subscription_id, or fb_login_id.

value string

Value associated with a type of data.

custom_data object array
field string

Custom date by facebook. Can be value, currency, order_id, predicted_ltv, num_items, status, or search_string.

value string

Value associated with a type of data.

{
    "network_id": 1,
    "network_affiliate_id": 7,
    "network_offer_id": 1,
    "network_offer_payout_revenue_id": 0,
    "delivery_method": "postback",
    "pixel_level": "global_offer",
    "pixel_status": "inactive",
    "pixel_type": "post_conversion",
    "postback_url": "http://test2.com{sub2}{sub1}",
    "html_code": "",
    "description": "Your postback",
    "facebook_pixel": null
}

cURL
curl --request POST 'https://api.eflow.team/v1/affiliates/pixels' \
--header 'X-Eflow-API-Key: <INSERT API KEY>' \
--header 'Content-Type: application/json' \
--data '<INSERT PAYLOAD>'
Response
{
    "network_pixel_id": 3,
    "network_id": 1,
    "network_affiliate_id": 0,
    "network_offer_id": 1,
    "network_offer_payout_revenue_id": 0,
    "delivery_method": "postback",
    "pixel_level": "global_offer",
    "pixel_status": "inactive",
    "pixel_type": "post_conversion",
    "postback_url": "http://test2.com{sub2}{sub1}",
    "html_code": "",
    "time_created": 1603484530,
    "time_saved": 1603484530,
    "relationship": {
        "offer": {
            "network_offer_id": 1,
            "network_id": 1,
            "network_advertiser_id": 13,
            "network_offer_group_id": 0,
            "name": "Offer Example",
            "offer_status": "active",
            "network_tracking_domain_id": 1,
            "visibility": "public",
            "currency_id": "USD"
        }
    },
    "facebook_pixel": null
}

Update

PUT /v1/networks/pixels/:pixelId

You must specify all the fields, not only the ones you wish to update.
If you omit a field that is not marked as required, its default value will be used.

Path Parameters

Parameter Description
pixelId The ID of the postback you want to update

network_affiliate_id int

ID of the affiliate related to the postback.

network_offer_id int

ID of the offer related to the postback.

network_offer_payout_revenue_id int

ID of the offer payout and revenue related to the postback.

delivery_method string

Select whether the postback will be fired from an HTML tag/pixel, or via an S2S (Server to Server) Postback. Can be html, postback or facebook.

pixel_level string

Determines if the postback should be used for all offers, or only one selected offer. Can either be global, specific or global_offer.

pixel_status string

Status of the postback. Can either be active or inactive.

pixel_type string

Determines type of postback. Conversion is fired for the based CV action and Event is for any post-conversion events. CPC is used specifically for individual offers that have CPC payouts, and fires on every unique payable click action. It can be a conversion, post_conversion or cpc.

postback_url string

Url of the postback. Note that the URL requires http(s)://

html_code string

HTML code of the postback.

description string

Optional description.

facebook_pixel object
network_affiliate_integration_facebook_business_id int

ID of the affiliate integration facebook business.

pixel_id string

ID of the postback

event_name string

Name of the event.

user_data object array
field string

Date type of the facebook user. Can be email, phone, gender, date_of_birth, last_name, first_name, city, state, zipcode, country_code, external_id, fbc, fbp, subscription_id, or fb_login_id.

value string

Value associated with a type of data.

custom_data object array
field string

Custom date by facebook. Can be value, currency, order_id, predicted_ltv, num_items, status, or search_string.

value string

Value associated with a type of data.

{
    "network_id": 1,
    "network_affiliate_id": 7,
    "network_offer_id": 1,
    "network_offer_payout_revenue_id": 0,
    "delivery_method": "postback",
    "pixel_level": "global",
    "pixel_status": "active",
    "pixel_type": "post_conversion",
    "postback_url": "http://test3.com{sub2}{sub1}",
    "html_code": "",
    "description": "Your postback",
    "facebook_pixel": null
}

cURL
curl --request POST 'https://api.eflow.team/v1/networks/pixels/<INSERT PIXEL ID' \
--header 'X-Eflow-API-Key: <INSERT API KEY>' \
--header 'Content-Type: application/json' \
--data '<INSERT PAYLOAD>'
Response
{
    "network_pixel_id": 3,
    "network_id": 1,
    "network_affiliate_id": 7,
    "network_offer_id": 0,
    "network_offer_payout_revenue_id": 0,
    "delivery_method": "postback",
    "pixel_level": "global",
    "pixel_status": "active",
    "pixel_type": "post_conversion",
    "postback_url": "http://test3.com{sub2}{sub1}",
    "html_code": "",
    "time_created": 1603484530,
    "time_saved": 1603485164,
    "relationship": {
        "affiliate": {
            "network_affiliate_id": 7,
            "network_id": 1,
            "name": "Affiliate Example",
            "account_status": "active",
            "network_employee_id": 2,
            "internal_notes": "",
            "has_notifications": false,
            "network_traffic_source_id": 0,
            "account_executive_id": 0,
            "adress_id": 0,
            "default_currency_id": "USD",
            "is_contact_address_enabled": false,
            "enable_media_cost_tracking_links": true,
            "time_created": 1602783082,
            "time_saved": 1602783082,
            "referrer_id": 0
        }
    },
    "facebook_pixel": null
}