Create a Contract

Description

This endpoint is used to create a contract.

Please note that the values for jobEntityId, orderEntityId, and containerEntityIds must be valid entity IDs that exist in the system and within the job or order, as relevant.

The assignmentType and services values will be sourced from controlled vocabulary endpoints Get Assignment Types and Get Work Order Services, respectively.

Within the characters array, you can provide one or more characterName values for voice talent contracts. The character names can be sourced from the Get Characters endpoint.

The dubbingStudioContactEntityId is optional, but if you wish to enforce a second signature on the contract from the dubbing studio, then you can provide the entity ID of a user that exists in the system. You can source users using the Search User endpoint. It is recommended you use the dubbing studio manager that was associated with the order via the claim order process using the Claim Order endpoint.

The counterSignatoryContactEntityId is optional, but if you need to add a counter signatory, then you can provide the entity ID of a valid counter signatory contact. You can retrieve the list of available counter signatories for an order using the Get Counter Signatories endpoint, which returns contacts based on the job's source and the territory associated with the order.

Within the talent object, the talentContactEntityId must be a valid entity ID for a contact in the system, and the talentSignerType must be one of the accepted enum values.

You can create a contact using the Create Contact endpoint. You can find a contact using Search Contact.

Endpoint

/v1/contracts

Request parameters

{
  "jobEntityId": "5694bc5f-8efa-4f25-b373-758904b7ff72",
  "orderEntityId": "37bfe568-687c-4567-acd0-c5ce72789ce9",
  "containerEntityIds": [
    "0d7a06e3-9bfb-43c7-a4b7-aef6ecd90bf9"
  ],
  "assignmentType": "translator",
  "talent": {
    "talentContactEntityId": "e0271d05-172a-4f01-a8cd-603e91364d86",
    "talentSignerType": "adult"
  },
  "services": [
    "vocal"
  ]
}

Responses

{
  "data": {
    "data": {
      "entityId": "f19178b5-8b7c-4dd2-b1f4-42cc006d2a91",
      "contract": {
        "studioEntityId": "2911bc73-4c5a-4e89-88bb-e55adac52500",
        "studioCode": "DBUS",
        "studio": {
          "studioName": "Dubbing Brothers US English Dub | Los Angeles",
          "studioCode": "DBUS",
          "studioEntityId": "2911bc73-4c5a-4e89-88bb-e55adac52500"
        },
        "contractNumber": "C-13738",
        "order": {
          "jobEntityId": "5694bc5f-8efa-4f25-b373-758904b7ff72",
          "jobName": "Bones: Season 1",
          "jobType": "dub",
          "orderId": "37bfe568-687c-4567-acd0-c5ce72789ce9",
          "orderNumber": 15805,
          "language": {
            "languageId": "ad2b59fa-e64f-448c-9b6d-4a21bcc9d07d",
            "languageName": "English"
          },
          "territory": {
            "territoryId": "efe81c44-c649-4af3-b20d-9b6a404243b8",
            "territoryName": "USA"
          },
          "vendor": {
            "vendorId": "3fb8ab94-3383-4aaa-9454-f707619c0cd1",
            "vendorName": "Dubbing Brothers",
            "vendorCode": "DBFR"
          },
          "externallyManaged": true
        },
        "contractSummary": {
          "status": "sent",
          "completedSignatures": 0,
          "totalSignatures": 1
        },
        "contractSigningMode": "externally signed",
        "characters": [],
        "assignmentType": "translator",
        "signers": [
          {
            "roleName": "Contributor",
            "signingOrder": 2,
            "signerType": "adult",
            "contactEntityId": "e0271d05-172a-4f01-a8cd-603e91364d86",
            "firstName": "Mickey",
            "lastName": "Mouse",
            "contactName": "Mickey Mouse",
            "contactEmail": "mickey.mouse@disney.com",
            "translatedContactName": "Mickey Mouse",
            "services": [
              "vocal"
            ],
            "isPrimary": true,
            "hasAgent": false,
            "isUnion": false,
            "isInducement": false,
            "sentDate": "2025-10-21T19:30:48.035+00:00",
            "signerStatus": "Ready to Sign"
          }
        ],
        "containers": [
          {
            "containerEntityId": "0d7a06e3-9bfb-43c7-a4b7-aef6ecd90bf9",
            "containerName": "Pilot",
            "containerType": "episode",
            "containerSequence": "1",
            "parentContainer": "Bones: Season 1"
          }
        ],
        "isArchived": false,
        "errors": [],
        "templates": []
      }
    }
  }
}

Examples

Dub Studio Contract

In the case of having only the minimum required fields for a dub studio contract, then the request body would look like the following.

It is recommended the entity id passed in the dubbingStudioContactEntityId field is the dubbing studio manager that was associated with the order via the claim order process using the Claim Order endpoint.

{
  "jobEntityId": "5694bc5f-8efa-4f25-b373-758904b7ff72",
  "orderEntityId": "37bfe568-687c-4567-acd0-c5ce72789ce9",
  "containerEntityIds": [
    "0d7a06e3-9bfb-43c7-a4b7-aef6ecd90bf9"
  ],
  "assignmentType": "dub studio",
  "dubbingStudioContactEntityId": "5ca67d33-4e96-40f3-9645-85e4459ce99b"
}

If the dub studio contract requires a counter signatory signature, include the counterSignatoryContactEntityId field:

{
  "jobEntityId": "5694bc5f-8efa-4f25-b373-758904b7ff72",
  "orderEntityId": "37bfe568-687c-4567-acd0-c5ce72789ce9",
  "containerEntityIds": [
    "0d7a06e3-9bfb-43c7-a4b7-aef6ecd90bf9"
  ],
  "assignmentType": "dub studio",
  "dubbingStudioContactEntityId": "5ca67d33-4e96-40f3-9645-85e4459ce99b",
  "counterSignatoryContactEntityId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Minimum Required Fields for Non-Voice Talent Contracts Without Services

In the case of having only the minimum required fields, which would be a non-voice talent contract for only an adult contributor and an assignmentType of artist label or lyric sheets, then the request body would look like the following. For these types, services are not required, so the request body would look like the following.

To add a dub studio manager signature, include the optional dubbingStudioContactEntityId field. To add a counter signatory signature, include the optional counterSignatoryContactEntityId field.

{
  "jobEntityId": "5694bc5f-8efa-4f25-b373-758904b7ff72",
  "orderEntityId": "37bfe568-687c-4567-acd0-c5ce72789ce9",
  "containerEntityIds": [
    "0d7a06e3-9bfb-43c7-a4b7-aef6ecd90bf9"
  ],
  "assignmentType": "artist label",
  "talent": {
    "talentContactEntityId": "e0271d05-172a-4f01-a8cd-603e91364d86",
    "talentSignerType": "adult"
  }
}

Minimum Required Fields for Non-Voice Talent Contracts With Services

In the case of having only the minimum required fields, which would be a non-voice talent contract for only an adult contributor, then the request body would look like the following.

Please note that replacing the assignmentType of translator with director, adapter, and are also all valid values for the contracts, too. Services are required for these types.

To add a dub studio manager signature, include the optional dubbingStudioContactEntityId field. To add a counter signatory signature, include the optional counterSignatoryContactEntityId field.

{
  "jobEntityId": "5694bc5f-8efa-4f25-b373-758904b7ff72",
  "orderEntityId": "37bfe568-687c-4567-acd0-c5ce72789ce9",
  "containerEntityIds": [
    "0d7a06e3-9bfb-43c7-a4b7-aef6ecd90bf9"
  ],
  "assignmentType": "translator",
  "talent": {
    "talentContactEntityId": "e0271d05-172a-4f01-a8cd-603e91364d86",
    "talentSignerType": "adult"
  },
  "services": [
    "vocal"
  ]
}

Minimum Required Fields for Voice Talent Contracts

In the case of having only the minimum required fields for a voice talent contract for only an adult contributor, then the characters section becomes required. Additionally, services are also required for voice talent contracts.

The character information can be sourced from the Get Characters endpoint.

To add a dub studio manager signature, include the optional dubbingStudioContactEntityId field. To add a counter signatory signature, include the optional counterSignatoryContactEntityId field. The following example demonstrates using a counter signatory:

{
  "jobEntityId": "5694bc5f-8efa-4f25-b373-758904b7ff72",
  "orderEntityId": "37bfe568-687c-4567-acd0-c5ce72789ce9",
  "containerEntityIds": [
    "0d7a06e3-9bfb-43c7-a4b7-aef6ecd90bf9"
  ],
  "assignmentType": "voice talent",
  "characters": [
    {
      "characterName": "Angela Montenegro"
    }
  ],
  "talent": {
    "talentContactEntityId": "e0271d05-172a-4f01-a8cd-603e91364d86",
    "talentSignerType": "adult"
  },
  "services": [
    "vocal"
  ]
}

Maximum Required Fields

In the case of having all required fields filled out, which would be a voice talent contract with multiple containers, a minor contributor and an agent, a dub studio manager, and a counter signatory, then the request body would look like this:

{
  "jobEntityId": "5694bc5f-8efa-4f25-b373-758904b7ff72",
  "orderEntityId": "37bfe568-687c-4567-acd0-c5ce72789ce9",
  "containerEntityIds": [
    "0d7a06e3-9bfb-43c7-a4b7-aef6ecd90bf9"
  ],
  "assignmentType": "voice talent",
  "characters": [
    {
      "characterName": "Angela Montenegro"
    }
  ],
  "dubbingStudioContactEntityId": "92bf631c-894a-4058-8867-3fb3dc1f8eda",
  "counterSignatoryContactEntityId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "talent": {
    "talentContactEntityId": "e0271d05-172a-4f01-a8cd-603e91364d86",
    "talentSignerType": "minor 14-18",
    "childContactEntityId": "1ceb2d89-5d09-441c-888e-ee751f10bde5",
    "agentContactEntityId": "e0271d05-172a-4f01-a8cd-603e91364d86"
  },
  "services": [
    "vocal"
  ]
}

Get Assignment Types: Retrieve valid assignment types.
Get Characters: Retrieve characters for voice talent contracts.
Get Counter Signatories: Retrieve counter signatory contacts for an order.
Claim Order: Claim an order for the dub studio manager on the contract.
Search Users: Search users to use as the dubbing studio contact.
Create Contact: Create a contact to use as talent.
Search Contacts: Search contacts to use as a talent.
Get Work Order Services: Retrieve valid work order services.
Upload Contract: Upload a completed contract.
Void Contract: Void an existing contract.
API Reference: See all available endpoints and details.

18 February 2026