--- title: "Create Additional Talent Tax" method: POST path: "/v3/talent/additional-tax" tags: ["Taxes"] --- # Create Additional Talent Tax `POST /v3/talent/additional-tax` Creates an additional tax for the talent record. ## Query parameters - `talentGuid` string, uuid - `talentExternalId` string ## Headers - `FrontOfficeTenantId` integer, required - `RequestOrigin` string, required - `RequestId` string, uuid, required — The unique request identifier used to correlate request data with log entries and events, formatted as a UUID. - `ExternalIdSource` 'BOLD', required - `RequestUserExternalId` string, required ## Request body - AdditionalTax - `taxId` integer, nullable — The unique identifier for the Tax. - `taxFilingStatusId` integer, nullable — The unique identifier for the selected Filing Status. - `dependents` integer, nullable — The number of dependents to set up for this tax. - `exemptions` integer — The number of exemptions to set up for this tax. - `AdditionalWithholding` number — A fixed amount of additional funds to withhold from the talent for this tax. - `hasMultipleJobs` boolean — An indication of whether this talent has multiple jobs. - `qualifyingChildren` number — A monetary amount associated with the number of qualifying children - `otherDependents` number, nullable — A monetary amount associated with the number of other dependents for the talent. - `otherIncome` number — The amount of the talent record's other income. - `deductions` number — The amount of deductions for the talent. ## Response `200` Talent tax detail created successfully. - TaxDetail - `employeeGuid` string, uuid — The unique identifier for the Talent record, formatted as a UUID. - `talentExternalId` integer — The unique identifier for the Talent record in the external system, formatted as an integer. - `employeeTaxGuid` string, uuid, nullable — The unique identifier for the Talent Tax record, formatted as a UUID. Null for federal W-4 tax records. - `taxId` integer, nullable — The unique identifier for the Tax Record. - `taxName` string — The name of the tax record. - `taxTypeId` integer, nullable — The unique identifier for the Tax Type record. - `taxType` string — The type of tax, either federal or state. - `vertexTaxId` integer, nullable — The unique identifier for the Vertex Tax record. - `taxFilingStatusId` integer, nullable — The unique identifier for the Tax Filing Status. - `taxFilingStatusName` string — The name of the tax filing status. - `exemptions` integer, nullable — The number of exemptions configured for this tax. - `dependents` integer, nullable — The number of dependents configured for this tax. - `additionalWithholding` number — A fixed amount of additional funds to withhold from the talent paycheck for this tax. - `fixedPercentage` number, nullable — A fixed percentage amount to use for calculating the amount withheld for this tax. - `fixedAmount` number, nullable — A fixed amount to withhold for this tax. - `active` boolean, nullable — An indication of whether this tax is currently active. - `isTaxExempt` boolean — An indication of whether the talent is exempt from this tax. - `nrCert` boolean, nullable — An indication of whether the talent has a non-resident certificate for this tax. - `exemptionAmount` number, nullable — The exemption amount for this tax. This value is only used for Canadian taxes. - `useDefaultExemptionAmount` boolean, nullable — An indication of whether the talent will use the default exemption amount or the amount configured in the __exemptionAmount__ field. This value is only used for Canadian taxes. - `prescribedZone` number, nullable — The prescribed zone for the tax record. Applicable only to Canadian taxes. - `hasLockInLetter` boolean — An indication of whether the talent has an IRS lock-in letter. - `resident` boolean, nullable — An indication of whether the talent is a resident of the state associated with this tax. - `nonResident` boolean, nullable — An indication of whether the talent is a non-resident of the state associated with this tax. - `officeDivision` string — The name of the division associated with this tax setup. - `federalW4Id` integer, nullable — The unique identifier for the federal W-4 row. This value will be non-null if the current tax record is U.S. federal income tax. - `hasMultipleJobs` boolean, nullable — An indication of whether this talent has multiple jobs. - `qualifyingChildren` number, nullable — The monetary amount associated with the number of qualifying children. - `otherDependents` number, nullable — The monetary amount associated with the number of other dependents for the talent. - `totalDependents` number, nullable — The monetary amount representing the total number of dependents across all sources. - `otherIncome` number, nullable — The amount of other income recorded for the talent. - `deductions` number, nullable — The amount of deductions for the talent. - `firstWorkedDate` string, date-time, nullable — The date the talent first worked at the current supplier. The field follows the ISO 8601-1:2019 format for date and time, for example, 2026-05-05T21:12:54.126Z. - `usWithholdingType` string — The withholding type for U.S. taxes, either nonresident alien or citizen. - `dateCompleted` string, date-time, nullable — The date the federal W-4 form was submitted by the talent. The field follows the ISO 8601-1:2019 format for date and time, for example, 2026-05-05T21:12:54.126Z. - `dateEntered` string, date-time, nullable — The date the talent tax row was entered into the Back Office database. The field follows the ISO 8601-1:2019 format for date and time, for example, 2026-05-05T21:12:54.126Z. - `stateCode` string — The state code associated with this tax record. - `revisionYear` number — The W4 revision year for this tax record. ## Other responses - `400` — Bad Request - `402` — Additional subscription required. - `403` — Access Denied - `404` — Not found - `405` — Unsupported method - `409` — Duplicate 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/versions/846b33e4e71b/schema)