Contracting & Hierarchies API

ContractAssignmentChangeDeletedWebhookEvent

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.assignment_change.deleted event.

Show Child Parameters
Example

Attachment

object

A file attachment included with a contract packet submission.

urlstring

The URL at which the attachment can be retrieved.

Example:https://s3.amazonaws.com/bucket/contract-packet.pdf

fileNamestring

The original file name of the attachment.

Example:contract-packet.pdf

sizestring

The file size of the attachment as a string representation of the byte count.

Example:204800

Example

ContractPacketSubmittedData

object

Payload for the contract.packet.submitted event.

contractPacketIdstring(uuid)required

The unique identifier of the contract packet.

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

submittedByPersonIdstring(uuid)required

The unique identifier of the individual producer which the contract packet is submitted for.

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

submittedByNamestringrequired

The name of the individual producer which the contract packet is submitted for.

Example:Smith, John

submissionDatestring(date-time)required

The timestamp of when the contract packet was submitted. Format: yyyy-MM-dd’T’HH:mm:ss’Z’

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

submissionMethodstringrequired

The method of how the contract packet was submitted.

Example:Email

contractIdstring(uuid)required

The unique identifier of the Contract associated with this packet.

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

contractNumberstringrequired

The display number of the Contract associated with this packet.

Example:C-00042

attachmentsarray[object]required

A file attachment included with a contract packet submission.

Show Child Parameters
Example

ContractPacketSubmittedWebhookEvent

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.packet.submitted event.

Show Child Parameters
Example

ContractUpdatedData

object

Payload for the contract.updated event.

contractIdstring(uuid)required

The unique identifier of the contract.

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

agencyOrganizationIdstring(uuid)required

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

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

agencyOrganizationNamestringrequired

The name of the agency organization which the contract is sent from.

Example:Acme Insurance Agency

carrierOrganizationIdstring(uuid)required

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

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

carrierOrganizationNamestringrequired

The name of the carrier organization which the contract is sent to.

Example:Big Carrier Inc.

personIdstring(uuid)required

The unique identifier of the individual producer which the contract is sent on behalf of.

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

personNpnstring | null

The National Producer Number of the individual producer.

Example:1234567

firmIdstring | null(uuid)

The unique identifier of the firm which the contract is sent on behalf of.

firmNpnstring | null

The National Producer Number of the firm.

responsibleUplineFirmIdstring | null(uuid)

The unique identifier of the upline firm responsible for this contract.

responsibleUplineFirmNpnstring | null

The National Producer Number of the upline firm responsible for this contract.

assignmentStatusIdstring | null(uuid)

The unique identifier of the assignment status which the contract is in.

assignmentStatusNamestring | null

The assignment status of the contract.

Example:Active

activebooleanrequired

Denotes if the contract is currently active based on the status of its contract assignments.

Example:true

effectiveDatestring(date)required

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

Example:2023-01-15

endDatestring | null(date)

The end date of the contract. Format: yyyy-MM-dd

contractCompletionDatestring | null(date)

The date contracting completed for this contract, from its latest active contract assignment. Format: yyyy-MM-dd

Example:2024-03-01

transferAvailableDatestring | null(date)

The date this contract becomes available to transfer, from its latest active contract assignment. Format: yyyy-MM-dd

Example:2025-03-01

notesstring | null

Internal notes visible to the agency, from the contract’s latest active contract assignment. Distinct from the externally visible notes (externalNotes) carried by the contract assignment events.

Example:Awaiting appointment confirmation from the carrier.

statesarray[string]

The administrative divisions (state abbreviations) covered by the contract’s active contract assignments. Empty when the contract has no active assignments.

Example:CA, TX

createdAtstring | null(date-time)

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

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

updatedAtstring | null(date-time)

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

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

displayNumberstring | null

The display number of the contract.

Example:C-00042

parentContractIdstring | null(uuid)

The unique identifier of the parent contract, if this is a subsidiary contract.

parentContractDisplayNumberstring | null

The display number of the parent contract, if this is a subsidiary contract.

userDefined1string | null

A user defined field of the contract.

userDefined2string | null

A user defined field of the contract.

userDefined3string | null

A user defined field of the contract.

userDefined4string | null

A user defined field of the contract.

userDefined5string | null

A user defined field of the contract.

userDefined6string | null

A user defined field of the contract.

userDefined7string | null

A user defined field of the contract.

userDefined8string | null

A user defined field of the contract.

userDefined9string | null

A user defined field of the contract.

userDefined10string | null

A user defined field of the contract.

Example