Skip to main content
POST
Record an Executed Producer Agreement
Records a signed PDF as the agency’s executed producer agreement. The result is the same as Upload Executed Agreement in the Turris app: the agreement shows in the agency’s Producer agreement section, the agency’s contract onboarding step is complete, and Producer Agreement Executed is sent to your webhook and to your team. Send the PDF as multipart/form-data in the file part, 25 MB at most. Signature dates and the effective date are read from the PDF shortly after the call. If the agency has no contract yet (for example an agency you added rather than invited), Turris creates it from your default active contract template, or without a template if you have no single default.

When nothing is recorded

Both of these answer 409 and write nothing:
  • contract_already_signed: the agency’s agreement is already executed. If you are retrying a call that may have succeeded, treat this as already recorded.
  • online_signing_in_progress: an online (DocuSign) signing is attached to the agreement. Send cancelOnlineSigning=true to cancel it and record this PDF in its place. Cancelling cannot be undone.

Uploading through Upload a Document

A Producer Agreement sent to Upload a Document is stored, but it does not execute the agreement. Use this endpoint instead.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

idempotency-key
string

UUID to ensure idempotent request processing

Example:

"550e8400-e29b-41d4-a716-446655440000"

x-idempotency-key
string

Alternative UUID header for idempotent request processing

Example:

"550e8400-e29b-41d4-a716-446655440000"

Path Parameters

downstreamEntityAssociationId
string
required

Downstream entity association ID

Example:

"507f1f77bcf86cd799439011"

Body

multipart/form-data
file
file
required

The signed producer agreement. PDF only, 25 MB maximum.

cancelOnlineSigning
boolean
default:false

Set to true to cancel an online (DocuSign) signing attached to the agreement and record this one in its place. Without it, an attached signing returns 409 online_signing_in_progress and nothing is recorded. Has no effect when no signing is attached.

Response

Executed producer agreement recorded

data
object
required
requestId
string
required

Unique request identifier

Example:

"dev-2c5e7cf2-9acf-4c8c-ab2f-b81f39d775a8"

timestamp
string
required

Response timestamp

Example:

"2025-11-12T20:49:03.293Z"