Sign in

v1

latestOpenAPI 3.0.12026-07-243124341009.5 KB
Talent

Post a Talent

Creates a new talent or updates an existing talent record if a matching ID is found.

post/v1/talent/{talentId}

Path parameters

talentIdstring required

The identifier for an existing talent that should be updated, or pass 0 to create a new talent record.

Headers

RequestIdstring uuid

The unique request identifier used to correlate request data with log entries and events, formatted as a UUID.

Unique request identifier (UUID) used to correlate request data with log entries and events.

FrontOfficeTenantIdinteger

An integer identifier for the tenant that the request is being made for. Required when Tenant header is not provided.

Tenantstring

Tenant company code that determines data access scope during the request. Required when FrontOfficeTenantId header is not provided.

Request body

talentGuidstring uuid required

The unique identifier for the Talent, formatted as a UUID.

branchGuidstring uuid

The unique identifier for the Branch associated with the Talent, formatted as a UUID.

backOfficeEmployeeIdinteger

The identifier for the Talent in the Back Office.

firstNamestring required

The first name of the talent.

middleNamestring

The middle name of the talent.

lastNamestring required

The last name of the talent.

taxIdNumberstring nullable

The national identification number used for federal taxes. For talent with resident address in the U.S. or Canada, this value may be provided as digits only or in the format 111-111-1111 and must be valid for the country of residence to be saved.

dateOfBirthstring date-time nullable

The date of birth of the talent. The field follows the ISO 8601-1:2019 format for date and time, for example, 2026-05-05T21:12:54.126Z.

mobilePhonestring

The primary mobile phone number of the talent, chosen from the Cell field. If multiple entries exist, the most recent one is selected.

emailAddressstring

The primary email address of the talent, chosen from the Email field. If multiple entries exist, the most recent one is selected.

gender'UNKNOWN' | 'M' | 'F' | 'N' | 'X'

Gender.

checkDeliveryOptionIdinteger nullable

The identifier for the talent's check delivery option.

Response

The created or updated talent record.

talentGuidstring uuid required

The unique identifier for the Talent, formatted as a UUID.

branchGuidstring uuid

The unique identifier for the Branch associated with the Talent, formatted as a UUID.

backOfficeEmployeeIdinteger

The identifier for the Talent in the Back Office.

firstNamestring required

The first name of the talent.

middleNamestring

The middle name of the talent.

lastNamestring required

The last name of the talent.

taxIdNumberstring nullable

The national identification number used for federal taxes. For talent with resident address in the U.S. or Canada, this value may be provided as digits only or in the format 111-111-1111 and must be valid for the country of residence to be saved.

dateOfBirthstring date-time nullable

The date of birth of the talent. The field follows the ISO 8601-1:2019 format for date and time, for example, 2026-05-05T21:12:54.126Z.

mobilePhonestring

The primary mobile phone number of the talent, chosen from the Cell field. If multiple entries exist, the most recent one is selected.

emailAddressstring

The primary email address of the talent, chosen from the Email field. If multiple entries exist, the most recent one is selected.

gender'UNKNOWN' | 'M' | 'F' | 'N' | 'X'

Gender.

checkDeliveryOptionIdinteger nullable

The identifier for the talent's check delivery option.