Create a Talent

post

https://api.avionte.com/front-office/v1/talent

Creates a new talent record.

Query Params

useNewTalentRequirements

string

An indication of whether new talent requirements from BOLD should be used when creating a new talent.

Body Params

Details of new talent to create.

int32

The identifier for the talent.

firstName

string

required

length ≤ 255

The talent's first name.

middleName

string

length ≤ 255

The talent's middle name.

lastName

string

required

length ≤ 255

The talent's last name.

homePhone

string

length ≤ 255

The talent's home phone.

workPhone

string

length ≤ 255

The talent's work phone.

mobilePhone

string

length ≤ 255

The talent's mobile phone.

emailAddress

string

required

length ≤ 255

The talent's email address.

emailAddress2

string

length ≤ 255

The talent's second email address.

taxIdNumber

string

length between 9 and 9

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

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

The talent's home address.

payrollAddress

The talent's payroll mailing address.

frontOfficeId

int32

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

length ≤ 255

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

length ≤ 255

The talent's disability status. Valid values are:

Individual with Disabilities

Individual without Disabilities

I do not wish to answer.

veteranStatus

string

length ≤ 255

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

int32

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

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

int32

The identifier for the talent's status.

createdDate

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

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

length ≤ 50

An indication of whether the talent profile is flagged. If flagged, the value should be specified as Green, Yellow or Red.

origin

string

required

length ≤ 50

The partner or vendor that originated the request. "API" will be appended by Avionté.

originRecordId

string

length ≤ 255

The identifier for the talent that can be used to link the record within the originating system.

officeName

string

length ≤ 255

The name of the talent's home office/branch.

officeDivision

string

length ≤ 255

The division of the talent's home office/branch.

status

string

length ≤ 50

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

length ≤ 50

Indicates if a talent has consented to receive text messages. Acceptable Values are "Opt Out", "Opt In", and "No Response".

talentResume

Resume of the talent.

hireDate

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

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

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

int32

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.

Headers

RequestId

uuid

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

FrontOfficeTenantId

integer

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

Tenant

string

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

Responses

401

Unauthorized

403

Access Denied

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

201The created talent record.

400Bad Request

404Not found