> ## 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.

# Partner Webhooks

> Webhook events fired when partners are created, updated, sign up, or have their signup reviewed.

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:**

| 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)

```json theme={null}
{
  "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:

```json theme={null}
{
  "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)

```json theme={null}
{
  "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
}
```