---
title: "Create a Talent"
method: POST
path: "/v1/talent"
tags: ["Talent"]
---

# Create a Talent

`POST /v1/talent`

Creates a new talent record.

## Query parameters

- `useNewTalentRequirements` string

## Headers

- `RequestId` string, uuid — The unique request identifier used to correlate request data with log entries and events, formatted as a UUID.
- `FrontOfficeTenantId` integer
- `Tenant` string

## Request body

- TalentDto
  - `id` integer — The identifier for the talent.
  - `firstName` string, required — The talent's first name.
  - `middleName` string — The talent's middle name.
  - `lastName` string, required — The talent's last name.
  - `homePhone` string — The talent's home phone.
  - `workPhone` string — The talent's work phone.
  - `mobilePhone` string — The talent's mobile phone.
  - `emailAddress` string, required — The talent's email address.
  - `emailAddress2` string — The talent's second email address.
  - `taxIdNumber` string — The numeric digits for the talent's Taxpayer Identification Number. It may be either the US SSN or the Canadian SIN. If the Canadian SIN is less than 9 digits, then 0's should be prepended to the number to reach 9 digits.
  - `birthday` string, date-time — The talent's birthday. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats, for example, 2000-12-01 or 2000-12-01T00:00:00.
  - `gender` string — The talent's gender. Valid values are "M" or "Male", "F" or "Female", "N" or "Non-Binary", "X" or "I Do Not Wish To Answer".
  - `residentAddress` Address
    - `addressGuid` string, uuid — Unique identifier for the address, formatted as a UUID.
    - `street1` string, required — Street address, line 1.
    - `street2` string — Street address, line 2.
    - `city` string, required — City.
    - `state` string, required — Province, state, or region.
    - `postalCode` string, required — ZIP/postal code.
    - `country` string, required — A 2-letter ISO 3166-1 alpha-2 code representing the country (e.g., "US", not "USA"). For details, see the <a href="https://developer.avionte.com/docs/general-guidelines#/data-formatting">General Guidelines</a>.
  - `payrollAddress` Address
    - `addressGuid` string, uuid — Unique identifier for the address, formatted as a UUID.
    - `street1` string, required — Street address, line 1.
    - `street2` string — Street address, line 2.
    - `city` string, required — City.
    - `state` string, required — Province, state, or region.
    - `postalCode` string, required — ZIP/postal code.
    - `country` string, required — A 2-letter ISO 3166-1 alpha-2 code representing the country (e.g., "US", not "USA"). For details, see the <a href="https://developer.avionte.com/docs/general-guidelines#/data-formatting">General Guidelines</a>.
  - `frontOfficeId` integer — The identifier for the talent’s home office/branch. It occupies the following position in the Front Office hierarchy: Division > Region > Office/Branch.
  - `race` string — The talent's race. Valid values are: American Indian or Alaska Native, Asian (Not Hispanic or Latino), Black or African American (Not Hispanic or Latino), Hispanic or Latino, Native Hawaiian or Other Pacific Islander, Two or More Races (Not Hispanic or Latino), White (Not Hispanic or Latino), I do not wish to answer.
  - `disability` string — The talent's disability status. Valid values are: Individual with Disabilities Individual without Disabilities I do not wish to answer.
  - `veteranStatus` string — The talent's veteran status. Valid values are: Armed Forces Services Medal Veteran Disabled Veteran Non Veteran Other Protected Veteran Recently Separated Veteran Active Wartime or Campaign Badge Veteran I do not wish to answer.
  - `representativeUser` integer, required — The user ID of the representative who is working with the talent.
  - `w2Consent` boolean — An indication of whether the talent has consented to receive the W-2 form electronically.
  - `availabilityDate` string, date-time — The date the talent is available for work. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats, for example, 2024-12-01 or 2024-12-01T14:30:00.
  - `statusId` integer — The identifier for the talent's status.
  - `createdDate` string, date-time — The date the talent profile was created. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats and also supports fractional seconds, such as YYYY-MM-DDTHH:mm:ss.sss. For example, 2024-12-01, 2024-12-01T14:30:00, and 2024-12-01T14:30:00.546.
  - `lastUpdatedDate` string, date-time — The date of the most recent update to the talent profile. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats and also supports fractional seconds, such as YYYY-MM-DDTHH:mm:ss.sss. For example, 2024-12-01, 2024-12-01T14:30:00, and 2024-12-01T14:30:00.546.
  - `flag` string — An indication of whether the talent profile is flagged. If flagged, the value should be specified as Green, Yellow or Red.
  - `origin` string, required — The partner or vendor that originated the request. "API" will be appended by Avionté.
  - `originRecordId` string — The identifier for the talent that can be used to link the record within the originating system.
  - `officeName` string — The name of the talent's home office/branch.
  - `officeDivision` string — The division of the talent's home office/branch.
  - `status` string — The status of the talent that can be passed in if the statusId is not known. When a new status value is passed, the status is added to the tenant's list of custom talent statuses, else we match on the string value to an existing talent status.
  - `textConsent` string — Indicates if a talent has consented to receive text messages. Acceptable Values are "Opt Out", "Opt In", and "No Response".
  - `talentResume` Resume
    - `resumeFilename` string — The file name for the resume that was uploaded.
    - `resumeText` string — Raw text of a resume if a file was not uploaded.
    - `resumeContents` string — The contents of the uploaded resume file passed as Base64 string content. Contents in this property will supersede any raw resume text that is passed in the ResumeText property.
  - `hireDate` string, date-time — The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats, for example, 2024-12-01 or 2024-12-01T14:30:00.
  - `terminationDate` string, date-time — The talent's date of termination with the staffing agency. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats, for example, 2024-12-01 or 2024-12-01T14:30:00.
  - `rehireDate` string, date-time — The talent's date of rehire with the staffing agency. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats, for example, 2024-12-01 or 2024-12-01T14:30:00.
  - `employmentTypeId` integer — The identifier for the talent's employment type which can represent a custom W-2, 1099, or C2C value.
  - `isGeneralApply` boolean — Indicates whether talent is general apply.

## Response `201`

The created talent record.

- Talent
  - `talentGuid` string, uuid, required — The unique identifier for the Talent, formatted as a UUID.
  - `branchGuid` string, uuid — The unique identifier for the Branch associated with the Talent, formatted as a UUID.
  - `backOfficeEmployeeId` integer — The identifier for the Talent in the Back Office.
  - `firstName` string, required — The first name of the talent.
  - `middleName` string — The middle name of the talent.
  - `lastName` string, required — The last name of the talent.
  - `residentAddress` TalentAddress
    - `addressGuid` string, uuid, required — The unique identifier for the address, formatted as a UUID.
    - `street1` string — The primary street address.
    - `street2` string — An additional street address.
    - `city` string — The city of the address.
    - `postalCode` string — The postal code associated with the address.
    - `state` string — The state associated with the address.
    - `country` string, required — The country associated with the address.
  - `taxIdNumber` string, 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.
  - `dateOfBirth` string, 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.
  - `mobilePhone` string — The primary mobile phone number of the talent, chosen from the __Cell__ field. If multiple entries exist, the most recent one is selected.
  - `emailAddress` string — 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.
  - `checkDeliveryOptionId` integer, nullable — The identifier for the talent's check delivery option.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Access Denied
- `404` — Not found
- `405` — Unsupported method
- `406` — Unsupported format(s) indicated by Accept header
- `409` — Operation could not be completed due to conflict.
- `415` — Unsupported format(s) indicated by the Content-Type header
- `429` — Too many requests
- `500` — An unexpected error occurred
- `502` — Service Unavailable
- `504` — Gateway Timeout

---

[API](https://skmtc.net/avionte/apis/aviont-partner-authorization-api.md) · [All operations](https://skmtc.net/avionte/apis/aviont-partner-authorization-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/avionte/aviont-partner-authorization-api/revisions/846b33e4e71b/schema)