Commission Line Item Events

Receive webhook events when individual commission line items are recorded in White Swan.

Receive webhooks when new commission line items occur. Several commission line items can be part of one payout event.

With this webhook, you'll receive events related to your own company account as well as the company accounts of your downlines.

---

Sample Payload

{
  "event_name": "First Year Commission",
  "event_date": "2026-04-20T15:45:00Z",
  "linked_commission_line_item": {
    "line_item_id": "1776772304993x781245903456120001",
    "line_item_external_id": "comm_ext_984512",
    "amount": 425.50,
    "premium_payment": 850.00,
    "premium_commission_percentage": 0.50,
    "payment_date": "2026-04-18T00:00:00Z",
    "statement_date": "2026-04-01T00:00:00Z",
    "payout_id": "1776772304993x781245903456120099",
    "linked_case": "1776772304993x781245903456120145",
    "linked_case_insured_name": "Michael Anderson",
    "linked_advisor": "1776772304993x781245903456120210",
    "linked_advisor_name": "Jane Doe",
    "advisor_split_percentage": 0.80,
    "linked_carrier": "1776772304993x781245903456120333",
    "linked_carrier_name": "John Hancock",
    "payment_recipient_id": "1776772304993x781245903456120444",
    "payment_recipient_name": "Acme Insurance Group LLC",
    "payor_id": "1776772304993x781245903456120555",
    "payor_name": "John Hancock",
    "payment_type": "Advance",
    "commission_type": "Target Premium"
  }
}

Data Returned by this Event:

Field Label	Field Key	Field Type	Example Value	Description
Event Name	event_name	Multiple-choice	Life First Year	See options below.
Event Date	event_date	Date/Time in ISO 8601	2024-03-15T14:30:00Z	The time the event was recorded.
Commission Line Item Object	linked_commission_line_item	Object	See Commission Line Item(s)	A commission line item object - see full Commission Line Item(s) documentation for shape reference.

Event name options:

Annuity Bonus
Annuity First Year
Annuity Renewal
Disability Bonus
Disability Excess
Disability First Year
Disability Renewal
Life Bonus
Life Excess
Life First Year
Life PUA
Life Renewal
Life Term Rider
Linked Benefit Bonus
Linked Benefit Excess
Linked Benefit First Year
Linked Benefit PUA
Linked Benefit Renewal
Linked Benefit Term Rider
LTC Bonus
LTC First Year
LTC Renewal
Variable Life Bonus
Variable Life Excess
Variable Life First Year
Variable Life Renewal
Minimum Fee