Create a Contact

Description

This endpoint is used to create a contact. The studioId field is used to associate the contact with a specific studio, which can be obtained from the Get Studios endpoint.

Endpoint

/v1/contacts

Request parameters

{
  "firstName": "Mickey",
  "lastName": "Mouse",
  "studioId": "e806110e-1ffe-4cbf-a6ef-fbccd18740fd"
}

Responses

{
  "data": {
    "entityId": "64bc08e4-0ceb-4d85-837e-808036ca72db"
  }
}

{
  "message": "The contact Mickey Mouse already exists for the studio e806110e-1ffe-4cbf-a6ef-fbccd18740fd",
  "errorCode": "E016",
  "errors": [
    {
      "path": "/v1/contacts",
      "message": "The contact Mickey Mouse already exists for the studio e806110e-1ffe-4cbf-a6ef-fbccd18740fd",
      "errorCode": "E016"
    }
  ],
  "meta": {
    "entityId": "48b75cd5-32b8-42b6-adb4-54a936909894"
  }
}

{
  "message": "Invalid email format: mickey.mousedisney.com",
  "errorCode": "UNPROCESSABLE_ENTITY",
  "errors": [
    {
      "path": "/v1/contacts",
      "message": "Invalid email format: mickey.mousedisney.com",
      "errorCode": "UNPROCESSABLE_ENTITY"
    }
  ]
}

Examples

Create Adult Contact

In addition to the required fields shown, you can also pass email and translatedLegalName for adult contacts.

{
  "firstName": "Mickey",
  "lastName": "Mouse",
  "studioId": "e806110e-1ffe-4cbf-a6ef-fbccd18740fd"
}

Create Minor Contact

What denotes a minor contact is the inclusion of the parentContactId field.

In addition to the required fields and parentContactId, you can also pass translatedLegalName for minor contacts.

{
  "firstName": "Mickey Jr.",
  "lastName": "Mouse",
  "studioId": "e806110e-1ffe-4cbf-a6ef-fbccd18740fd",
  "parentContactId": "2d6b99c0-61e8-47ab-8daa-482b9790d458"
}

Get Studios: Retrieve valid studio IDs for creating contacts.
Search Contacts: Look up existing contacts before creating a new one.
Update Contact: Update an existing contact.
Create Contract: Use a contact as talent in a contract.
API Reference: See all available endpoints and details.