APIs
Start typing to search…

Post a Talent

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

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

Path Params
string
required

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

Body Params
int32

The identifier for the talent.

string
length ≤ 255

The talent's first name.

string
length ≤ 255

The talent's middle name.

string
length ≤ 255

The talent's last name.

string
length ≤ 255

The talent's home phone.

string
length ≤ 255

The talent's work phone.

string
length ≤ 255

The talent's mobile phone.

string
length ≤ 255

The talent's pager number.

string
length ≤ 255

The talent's email address.

string
length ≤ 255

The talent's second email address.

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 will be prepended to the number to reach 9 digits.

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.

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".

date-time

The talent's date of hire 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.

residentAddress

The talent's home address.

mailingAddress

The talent's mailing address.

payrollAddress

The talent's payroll mailing address.

addresses
array of objects

An address array containing only the talent's home address.

addresses
string
length ≤ 50

The talent's status.

enum

The talent's tax filing status.

int32

Federal withholding exemptions.

int32

State withholding exemptions.

number

Additional amount of money that is withheld from the talent's each paycheck based on the talent's request.

date-time

The date the talent's I-9 document was verified. 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.

int32

The identifier for the talent’s home office/branch. It occupies the following position in the Front Office hierarchy: Division > Region > Office/Branch.

date-time

The date of the talent's latest activity. 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. If the timestamp includes a Z (e.g., YYYY-MM-DDTHH:mm:ssZ or YYYY-MM-DDTHH:mm:ss.sssZ), it indicates UTC time. For example, 2024-12-01, 2024-12-01T14:30:00, 2024-12-01T14:30:00.546, 2024-12-01T14:30:00Z, and 2024-12-01T14:30:00.546Z.

string
length ≤ 255

The talent's latest activity type.

string

URL to the talent profile.

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.

string
length ≤ 255

The talent's disability status. Valid values are

Individual with Disabilities

Individual without Disabilities

I do not wish to answer

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

boolean

An indication of whether the talent has opted out of receiving emails from Avionté BOLD or not.

boolean

An indication of whether the talent record is archived or not.

string

The talent's current placement status. Possible values are: "Active Contractor", "Permanently Placed", "Not Active Contractor".

int32

The user ID of the representative who is working with the talent.

boolean

An indication of whether the talent has consented to receive the W-2 form electronically or not.

boolean

An indication of whether the talent has consented to receive the 1095-C form electronically or not.

string

A comma-delimited list of usernames who referred the talent, with each name followed by an indicator specifying the type of user (Applicant or Contact).

date-time

The date when 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.

int32

The talent's status ID.

string
length ≤ 255

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

string
length ≤ 255

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

int32

The ID of the user who entered the talent record.

string
length ≤ 255

The email of the user who entered the talent record.

string
length ≤ 255

The email of talent's representative user.

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.

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.

string
length ≤ 255

The most recent employment of the talent (company - position).

date-time

The date the talent was last contacted via the Send Email option on their profile. The field follows the ISO 8601-1:2019 format for date and time, for example, 2024-12-01T14:30:00Z or 2024-12-01T14:30:00.1234567+00:00.

string
length ≤ 50

An indication of whether the talent profile is flagged. If flagged, the value is specified as Green, Yellow or Red or "" for cases when an empty value is selected.

string
length ≤ 50

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

string
length ≤ 255

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

boolean

An indication of whether the talent has consented to the electronic delivery of forms or not.

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.

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.

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.

int32

The identifier for the talent's employment type which can represent a custom W-2, 1099, or C2C value.

string
length ≤ 15

The type of employment associated to the talent's custom employment type value which can be either W-2, 1099, or C2C.

string
length ≤ 50

The talent's custom employment type value.

Headers
uuid

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

integer

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

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

Updated about 1 year ago

Language
Credentials
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
Updated about 1 year ago