Skip to main content
Partner webhooks notify your endpoint when changes occur to partner (affiliate) accounts in your network.

Events

Partner Created

Fired when a new partner is created at the top level. This event does not fire when creating additional users for an existing partner. Payload: Matches the Find Affiliate By ID endpoint response with users and billing relationships.

Partner Updated

Fired when the partner record itself is updated. Triggers include:
  • Account manager changes
  • Address updates
  • Billing modifications
Does NOT trigger for:
  • Offer visibility grants
  • Postback changes
  • User creation or updates
Payload: Same structure as Partner Created.

Partner Signed Up

Fired when a partner self-registers via the signup form. If email verification is enabled, this event only fires after the partner verifies their email. Payload: Includes users, billing, and signup relationships. Additional signup fields:
  • website_url, referral_code, advertise_method, heard_about_us
  • user_ip, user_agent, phone, tax_id, legal_type
  • mailing_address, promotional_information

Partner Sign Up Verdict

Fired when a network employee approves or rejects a signup application. Note: The Partner Updated webhook also fires when this event occurs. This webhook uses a custom flat payload that does not match the standard Find Affiliate By ID response. Payload:
FieldTypeDescription
network_idintegerNetwork identifier
network_affiliate_idintegerPartner identifier
network_affiliate_namestringPartner name
new_statusenumNew status value (maps to the partner account status)
employee_idintegerEmployee who made the decision
employee_full_namestringFull name of the employee
timestampintegerUnix timestamp of the last update to the partner record

Common Payload Fields

All partner webhook payloads (except Sign Up Verdict) include:
FieldTypeDescription
network_affiliate_idintegerUnique partner identifier
network_idintegerNetwork identifier
namestringPartner name
account_statusstringAccount status
default_currency_idstringDefault currency
network_traffic_source_idintegerTraffic source
time_createdintegerCreation timestamp
time_savedintegerLast update timestamp

Example Payload (Created / Updated)

{
  "network_affiliate_id": 456,
  "network_id": 1,
  "name": "Performance Agency LLC",
  "account_status": "active",
  "network_employee_id": 102,
  "account_executive_id": 103,
  "default_currency_id": "USD",
  "network_traffic_source_id": 5,
  "internal_notes": "",
  "time_created": 1709500000,
  "time_saved": 1709500000,
  "relationship": {
    "labels": {
      "total": 2,
      "label_entry_list": ["tier1", "mobile"]
    },
    "account_manager": {
      "first_name": "Bob",
      "last_name": "Handler",
      "email": "bob@network.com",
      "cell_phone": "+1-555-0200",
      "work_phone": "+1-555-0201"
    },
    "account_executive": {
      "first_name": "Alice",
      "last_name": "Executive",
      "email": "alice@network.com"
    },
    "contact_address": {
      "network_address_id": 666,
      "address_line_1": "456 Partner Ave",
      "city": "San Francisco",
      "state": "CA",
      "postal_code": "94105",
      "country_code": "US"
    },
    "users": {
      "total": 1,
      "user_entities": [
        {
          "network_affiliate_user_id": 2001,
          "network_affiliate_id": 456,
          "first_name": "Jane",
          "last_name": "Affiliate",
          "email": "jane@agency.com",
          "title": "Affiliate Manager",
          "account_status": "active",
          "work_phone": "+1-555-2234",
          "cell_phone": "+1-555-6678",
          "language_id": 1,
          "timezone_id": 12,
          "currency_id": "USD",
          "time_created": 1709500000,
          "time_saved": 1709500000
        }
      ]
    },
    "billing": {
      "network_affiliate_billing_id": 3001,
      "network_affiliate_id": 456,
      "invoice_method": "manual",
      "payment_method": "ach",
      "payment_term_days": 14,
      "currency_id": "USD"
    }
  }
}

Example Payload (Signed Up)

The Signed Up event includes the same base structure as Created/Updated, with an additional sign_up relationship:
{
  "network_affiliate_id": 457,
  "network_id": 1,
  "name": "New Partner Co",
  "account_status": "pending",
  "default_currency_id": "USD",
  "network_traffic_source_id": 0,
  "time_created": 1709500000,
  "time_saved": 1709500000,
  "relationship": {
    "users": {
      "total": 1,
      "user_entities": [
        {
          "network_affiliate_user_id": 2010,
          "network_affiliate_id": 457,
          "first_name": "Tom",
          "last_name": "Partner",
          "email": "tom@newpartner.com",
          "account_status": "active",
          "time_created": 1709500000,
          "time_saved": 1709500000
        }
      ]
    },
    "billing": {
      "network_affiliate_billing_id": 3010,
      "network_affiliate_id": 457,
      "currency_id": "USD"
    },
    "sign_up": {
      "network_affiliate_signup_info_id": 4002,
      "network_affiliate_id": 457,
      "company_description": "Performance marketing agency",
      "website_url": "https://newpartner.com",
      "time_created": 1709500000,
      "time_saved": 1709500000,
      "relationship": {
        "custom_field_values": [
          {
            "network_affiliate_signup_info_custom_field_value_id": 5002,
            "network_affiliate_id": 457,
            "network_signup_custom_field_id": 701,
            "value": "Social Media"
          }
        ],
        "mailing_address": {
          "network_address_id": 888,
          "address_line_1": "789 Agency Blvd",
          "city": "San Francisco",
          "state": "CA",
          "postal_code": "94105",
          "country_code": "US"
        },
        "promotional_information": [
          {
            "network_affiliate_promotional_information_id": 6001,
            "promotion_type": "blog",
            "promotion_description": "Featured in industry blogs"
          }
        ]
      }
    }
  }
}

Example Payload (Sign Up Verdict)

{
  "network_id": 1,
  "network_affiliate_id": 457,
  "network_affiliate_name": "New Partner Co",
  "new_status": "active",
  "employee_id": 102,
  "employee_full_name": "Bob Handler",
  "timestamp": 1709500000
}