Contracting & Hierarchies API

PageInfo

object

Pagination metadata for a V2 list response.

sizeintegerrequired

Number of items returned in this response (equal to items.length).

nextTokenstring | nullrequired

Opaque continuation token for the next page, or null on the last page.

Example

ApiError

object

The AgentSync error shape.

messagestringrequired

A human-readable description of the error.

detailsarray[object]

Optional field-level details.

Show Child Parameters
Example

WebhookEventEnvelope

object

Common wrapper present on every outbound webhook event. The data field
is polymorphic; its schema depends on the value of type.

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

Example

ProducerStatusUpdatedData

object

Payload for the contract.producer_status.updated event.

producerIdstring(uuid)required

The unique identifier of the producer.

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

npnstring | null

The National Producer Number of the producer.

Example:1234567

organizationIdstring(uuid)required

The unique identifier of the organization which the producer’s role and status has been updated for.

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

organizationNamestringrequired

The name of the organization which the producer’s role and status has been updated for.

Example:Acme Insurance Agency

startDatestring(date)required

The date of when the producer started with their organization. Format: yyyy-MM-dd

Example:2023-01-15

endDatestring | null(date)

The date of when the producer ended with their organization. Format: yyyy-MM-dd

statusIdstring(uuid)required

The unique identifier of the status of the producer.

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

statusNamestringrequired

The name of the status of the producer.

Example:Active

activebooleanrequired

Denotes if the producer is currently active with their organization.

Example:true

updatedAtstring | null(date-time)

Timestamp of when this record was last updated. Format: yyyy-MM-dd’T’HH:mm:ss’Z’

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

hireDatestring | null(date)

The date the producer was hired by their organization. Format: yyyy-MM-dd

Example:2023-01-15

Example

ProducerStatusUpdatedWebhookEvent

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.producer_status.updated event.

Show Child Parameters
Example