Contracting & Hierarchies API

ContractDeletedData

object

Payload for the contract.deleted event.

contractIdstring(uuid)required

The unique identifier of the contract.

Example:550e8400-e29b-41d4-a716-446655440000

Example

ContractDeletedWebhookEvent

idstringrequired

Globally unique event identifier. Uses the TypeID format with the
prefix whe_ followed by a UUIDv7-derived suffix
(e.g. whe_01j8e4k2abc123def456). Use this field to deduplicate
deliveries if your endpoint receives the same event more than once.

Example:whe_01j8e4k2abc123def456

typestringrequired

Dot-notation event type string. Use this field to route the event to
the appropriate handler in your integration.

Allowed values:contract.producer_status.updatedcontract.assignment.updatedcontract.assignment.deletedcontract.assignment_change.updatedcontract.assignment_change.deletedcontract.packet.submittedcontract.updatedcontract.deletedcontract.responsible_party.updatedhierarchy.producer.addedhierarchy.producer.changedhierarchy.producer.relationship.terminated

Example:contract.assignment.updated

dataobjectrequired

Payload for the contract.deleted event.

Show Child Parameters
Example

ContractResponsiblePartyData

object

Payload for the contract.responsible_party.updated event.

idstring(uuid)required

The unique identifier of the contract responsible party.

Example:550e8400-e29b-41d4-a716-446655440000

contractIdstring(uuid)required

The unique identifier of the contract the responsible party belongs to.

Example:110e8400-e29b-41d4-a716-446655440009

contractDisplayNumberstring | null

The display number of the contract the responsible party belongs to.

Example:C-00042

responsiblePartyIdstring(uuid)required

The unique identifier of the party responsible for the contract.

Example:dd0e8400-e29b-41d4-a716-446655440007

startDatestring(date)required

The date the responsible party window begins. Format: yyyy-MM-dd

Example:2024-06-18

endDatestring | null(date)

The date the responsible party window ends; null when the window is open-ended. Format: yyyy-MM-dd

Example

ContractResponsiblePartyUpdatedWebhookEvent

idstringrequired

Globally unique event identifier. Uses the TypeID format with the
prefix whe_ followed by a UUIDv7-derived suffix
(e.g. whe_01j8e4k2abc123def456). Use this field to deduplicate
deliveries if your endpoint receives the same event more than once.

Example:whe_01j8e4k2abc123def456

typestringrequired

Dot-notation event type string. Use this field to route the event to
the appropriate handler in your integration.

Allowed values:contract.producer_status.updatedcontract.assignment.updatedcontract.assignment.deletedcontract.assignment_change.updatedcontract.assignment_change.deletedcontract.packet.submittedcontract.updatedcontract.deletedcontract.responsible_party.updatedhierarchy.producer.addedhierarchy.producer.changedhierarchy.producer.relationship.terminated

Example:contract.assignment.updated

dataobjectrequired

Payload for the contract.responsible_party.updated event.

Show Child Parameters
Example

HierarchyProducerEventData

object

Shared payload for the hierarchy.producer.added and
hierarchy.producer.changed events. Describes a producer’s placement in a
hierarchy - its upline and commission level - derived from a
contract-assignment change. The upline and commission values reflect the
new placement; no prior value is included. changedFields is present only
on hierarchy.producer.changed.

contractAssignmentChangeIdstring(uuid)required

The unique identifier of the contract assignment change that drove this hierarchy event.

Example:550e8400-e29b-41d4-a716-446655440000

contractAssignmentIdstring(uuid)required

The unique identifier of the contract assignment the producer holds in the hierarchy.

Example:660e8400-e29b-41d4-a716-446655440001

contractIdstring | null(uuid)

The unique identifier of the contract the assignment belongs to.

Example:110e8400-e29b-41d4-a716-446655440009

personIdstring(uuid)required

The unique identifier of the individual producer whose hierarchy placement changed.

Example:990e8400-e29b-41d4-a716-446655440004

personNpnstring | null

The National Producer Number of the individual producer.

Example:1234567

firmIdstring | null(uuid)

The unique identifier of the firm the producer is contracted under, if any.

firmNpnstring | null

The National Producer Number of the firm, if any.

agencyOrganizationIdstring(uuid)required

The unique identifier of the agency organization the contract is sent from.

Example:770e8400-e29b-41d4-a716-446655440002

carrierOrganizationIdstring(uuid)required

The unique identifier of the carrier organization the contract is sent to.

Example:880e8400-e29b-41d4-a716-446655440003

productIdstring | null(uuid)

The unique identifier of the carrier product the producer is contracted for.

Example:aa0e8400-e29b-41d4-a716-446655440005

writingNumberstring | null

The writing number of the producer’s contract assignment.

Example:0012345

uplineContractAssignmentIdstring | null(uuid)

The unique identifier of the upline contract assignment the producer is placed under.

Example:dd0e8400-e29b-41d4-a716-446655440007

uplineNpnstring | null

The National Producer Number of the upline producer.

Example:7654321

uplineFirmIdstring | null(uuid)

The unique identifier of the upline firm, if any.

uplineFirmNpnstring | null

The National Producer Number of the upline firm, if any.

uplineContractAssignmentChangeOne Of

The curated upline contract assignment change identity, if the placement has an upline.

UplineContractAssignmentChangeEventDataobject

Curated, single-level identity of a contract assignment change’s upline change. The upline is part of the recipient’s own hierarchy; firmName/personName may be null.

Show Child Parameters
commissionLevelIdstring | null(uuid)

The unique identifier of the producer’s commission level.

Example:ee0e8400-e29b-41d4-a716-446655440010

commissionLevelNamestring | null

The name of the producer’s commission level.

Example:Level A

assignmentStatusNamestring | null

The name of the producer’s assignment status.

Example:Active

effectiveDatestring | null(date)

The effective date of the placement. Format: yyyy-MM-dd

Example:2024-06-18

changedFieldsarray | null[string]

The hierarchy dimensions this change affected (upline,
commissionLevel). Present on hierarchy.producer.changed; absent on
hierarchy.producer.added.

Example:upline, commissionLevel

createdAtstring | null(date-time)

The date and time the underlying change was created. Format: RFC3339 UTC.

Example:2024-06-18T09:15:00Z

updatedAtstring | null(date-time)

The date and time the underlying change was last updated. Format: RFC3339 UTC.

Example:2024-06-20T14:45:00Z

Example