Producer Agreement Executed

Webhooks belong to the Carrier & MGA API. This event fires about an agency you appoint, and only a credential on that surface (carrier, MGA or wholesaler) can subscribe to it.

Overview

The PRODUCER_AGREEMENT_EXECUTED webhook is triggered when a downstream entity (agency) and your upstream entity have fully executed a producer agreement — meaning both parties have signed the contract. Webhook type: PRODUCER_AGREEMENT_EXECUTED

Triggers

This webhook fires when:

Both the upstream entity and downstream entity have signed the producer agreement (via DocuSign or offline upload), completing contract execution

This webhook is sent immediately — no debouncing is applied, since contract execution is a discrete, one-time event per association.

Payload Example

{
  "webhookType": "PRODUCER_AGREEMENT_EXECUTED",
  "upstreamEntityId": "507f1f77bcf86cd799439010",
  "payload": {
    "downstreamEntityAssociationId": "507f1f77bcf86cd799439011",
    "downstreamEntityId": "507f1f77bcf86cd799439012",
    "producerCode": "ABC123",
    "branchName": "Main Branch",

    "contractContainerInstanceId": "6a171043c80172422211a416",
    "contractContainerTemplateId": "6a13495a5415a8bb4ac83b5d",
    "contractContainerTemplateName": "Producer Agreement",
    "signedFileDocumentId": "6a1710bcc80172422211a421"
  }
}

Field Reference

Payload Fields

Field	Type	Description
`downstreamEntityAssociationId`	string	The ID of the association between the downstream entity and your upstream entity
`downstreamEntityId`	string	The ID of the downstream entity (agency) that executed the agreement
`producerCode`	string \| null	The producer code assigned to the downstream entity for this association. `null` if none has been assigned yet, or if the only value on record is an internal identifier Turris generated for its own bookkeeping rather than one you issued.
`branchName`	string	The branch name of the association
`contractContainerInstanceId`	string?	The ContractContainer instance ID of the executed contract. Stable identifier for this specific signed agreement. Optional: may be absent for legacy in-flight envelopes signed before the ContractContainer migration.
`contractContainerTemplateId`	string?	The ContractContainer template ID this instance was created from. Same value you would have supplied as `contractContainerTemplateId` on the Invite Downstream Entity call. Optional: see note above.
`contractContainerTemplateName`	string?	Human-readable template name (the same `name` returned by List Contract Container Templates). Optional: see note above.
`signedFileDocumentId`	string?	The FileDocument ID of the executed signed PDF. Use with List File Documents to read its metadata and version history. No endpoint returns a download URL for it. Optional: see note above.

The four contractContainer* and signedFileDocumentId fields were added in May 2026. They are present for all new contract executions but may be absent for associations signed before the ContractContainer migration. Treat them as optional in your handler.

Start Here

Shared Endpoints

Products

Agencies You Appoint

Contract Container Templates

Agents

Contacts

Market Contacts

Licenses

Appointments

Compliance Data Subscriptions

Compliance Status

File Documents

Policy Ingestion

Policy Transactions

Surplus Lines Filings

Webhooks

E&O/Cyber Compliance

Regulatory Actions

Tools

Overview

Triggers

Payload Example

Field Reference

Payload Fields

​Overview

​Triggers

​Payload Example

​Field Reference

​Payload Fields

Overview

Triggers

Payload Example

Field Reference

Payload Fields