Skip to main content

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.

Offer webhooks notify your endpoint when changes occur to offers in your network.

​
Events

​
Offer Created

Fired when a new offer is created. This event does not fire when related objects are created (e.g., new offer URLs, Smart Links, or creatives). Payload: Matches the Find Offer By ID endpoint response with the targeting relationship always included.

​
Offer Updated

Fired when the offer itself is modified. Triggers include:
  • Name or description changes
  • Payout/revenue setting additions or modifications
  • Cap configuration changes
  • Fail traffic setting adjustments
Does NOT trigger for:
  • Partner visibility grants
  • Offer group modifications
  • Custom payout/revenue for specific partners
  • New or modified offer URLs
Payload: Same structure as Offer Created (includes targeting relationship).

​
Payload Fields

FieldTypeDescription
network_offer_idintegerUnique offer identifier
network_idintegerNetwork identifier
network_advertiser_idintegerAssociated advertiser
namestringOffer name
offer_statusstringStatus (active, paused, pending)
currency_idstringCurrency code
destination_urlstringDefault destination URL
preview_urlstringPreview URL
visibilitystringVisibility level
daily_conversion_capintegerDaily conversion cap
weekly_conversion_capintegerWeekly conversion cap
monthly_conversion_capintegerMonthly conversion cap
global_conversion_capintegerLifetime conversion cap

​
Relationship Objects

  • targeting: Offer targeting configuration (always included in webhook payloads)
  • category: Offer category details
  • labels: Applied labels
  • payouts: Payout/revenue entries
  • channels: Associated channels
  • thumbnail_asset: Thumbnail image details

​
Example Payload

{
  "network_offer_id": 12345,
  "network_id": 1,
  "network_advertiser_id": 789,
  "network_category_id": 456,
  "name": "Premium Subscription Offer",
  "offer_status": "active",
  "currency_id": "USD",
  "destination_url": "https://brand.com/subscribe?tid={transaction_id}",
  "preview_url": "https://brand.com/subscribe",
  "visibility": "require_approval",
  "daily_conversion_cap": 500,
  "weekly_conversion_cap": 0,
  "monthly_conversion_cap": 10000,
  "global_conversion_cap": 0,
  "time_created": 1709500000,
  "time_saved": 1709500000,
  "relationship": {
    "labels": {
      "total": 2,
      "label_entry_list": ["premium", "subscription"]
    },
    "category": {
      "network_category_id": 456,
      "name": "E-Commerce"
    },
    "channels": {
      "total": 1,
      "channel_entities": [
        {
          "network_channel_id": 111,
          "name": "Web"
        }
      ]
    },
    "payout_revenue": {
      "total": 1,
      "payout_revenue_entities": [
        {
          "network_offer_payout_revenue_id": 222,
          "event_type": "conversion",
          "payout_type": "fixed",
          "payout_value": 25.00,
          "payout_currency_id": "USD",
          "revenue_type": "fixed",
          "revenue_value": 100.00,
          "is_default": true,
          "must_approve_conversion": false,
          "allow_duplicate_conversion": false
        }
      ]
    },
    "advertiser": {
      "network_advertiser_id": 789,
      "name": "Brand Corporation"
    },
    "targeting": {
      "geo": {
        "countries": ["US", "CA", "GB"]
      },
      "device_types": ["desktop", "mobile"],
      "platforms": ["windows", "ios", "android"]
    }
  }
}