Skip to main content

​
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": "03-e55f06b3-618c-4bf2-b578-efae34a87a6e",
    "branchName": "Main Branch",

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

​
Field Reference

​
Payload Fields

FieldTypeDescription
downstreamEntityAssociationIdstringThe ID of the association between the downstream entity and your upstream entity
downstreamEntityIdstringThe ID of the downstream entity (agency) that executed the agreement
producerCodestring | nullThe producer code assigned to the downstream entity for this association. null if no producer code has been assigned yet.
branchNamestringThe branch name of the association
contractContainerInstanceIdstring?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.
contractContainerTemplateIdstring?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.
contractContainerTemplateNamestring?Human-readable template name (the same name returned by List Contract Container Templates). Optional: see note above.
signedFileDocumentIdstring?The FileDocument ID of the executed signed PDF. Use with List File Documents to retrieve a download URL. 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.