Partner Webhooks - Everflow API

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

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:

Field	Type	Description
`network_id`	integer	Network identifier
`network_affiliate_id`	integer	Partner identifier
`network_affiliate_name`	string	Partner name
`new_status`	enum	New status value (maps to the partner account status)
`employee_id`	integer	Employee who made the decision
`employee_full_name`	string	Full name of the employee
`timestamp`	integer	Unix timestamp of the last update to the partner record

Common Payload Fields

All partner webhook payloads (except Sign Up Verdict) include:

Field	Type	Description
`network_affiliate_id`	integer	Unique partner identifier
`network_id`	integer	Network identifier
`name`	string	Partner name
`account_status`	string	Account status
`default_currency_id`	string	Default currency
`network_traffic_source_id`	integer	Traffic source
`time_created`	integer	Creation timestamp
`time_saved`	integer	Last 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"
          }
        ]
      }
    }
  }
}

{
  "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
}

​Events

​Partner Created

​Partner Updated

​Partner Signed Up

​Partner Sign Up Verdict

​Common Payload Fields

​Example Payload (Created / Updated)

​Example Payload (Signed Up)

​Example Payload (Sign Up Verdict)