addPayrollTaxExemption

curl --request POST \
  --url 'https://sandbox.rollfi.xyz/payroll#addPayrollTaxExemption' \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "method": "addPayrollTaxExemption",
  "companyId": "ECF1B47E-108F-45C0-A520-6A128A727B04",
  "userId": "33820169-85C2-482A-BCCF-B2281419E96E",
  "taxName": "WA - State paid family medical leave ER",
  "exemptionEffectiveStartDate": "2026-02-30",
  "exemptionEffectiveEndDate": "2025-12-31",
  "exemptReason": "Employer claimed exempt on W-4",
  "exemptConfirmation": true,
  "fileName": "tax.pdf",
  "fileBase64": "JVBERi0xLjcNCiW1tbW1DQoxIDAgb2JqDQo8PC9UeXBlL0NhdGFsb2cvUGFnZXMgMiAwIFIvTGFuZyhlbikgL1N0cnVjdFRyZWVSb290IDIyIDAgUi9NYXJrSW5mbzw8L01hcmtlZCB0cnVlPj4vTWV0YWRhdGEgMTk3IDAgUi9WaWV3ZXJQcmVmZXJlbmNlcyAxOTggMCBSPj4NCmVuZG9iag0KMiAwIG9iag0KPDwvVHlwZS9QYWdlcy9Db3VudCAxL0tpZHNbIDMgMCBSXSA+Pg0KZW5kb2JqDQozIDAgb2JqDQo8PC9UeXBlL1BhZ2UvUGFyZW50IDIgMCBSL1Jlc291cmNlczw8L0V4dEdTdGF0ZTw8L0dTNSA1IDAgUi9HUzggOCAwIFI+Pi9YT2JqZWN0PDwvSW1hZ2U2IDYgMCBSPj4vRm9udDw8L0YxIDkgMCBSL0YyIDExIDAgUi9GMyAxMyAwIFIvRjQgMTUgMCBSPj4vUHJvY1NldFsvUERGL1RleHQvSW1hZ2VCL0ltYWdlQy9JbWFnZUldID4+L0Fubm90c1sgMjAgMCBSXSAvTWVkaWFCb3hbIDAgMCA2MTIgNzkyXSAvQ29udGVudHMgNCAwIFIvR3JvdXA8PC9UeXBlL0dyb3VwL1MvVHJhbnNwYXJlbmN5L0NTL0RldmljZVJHQj4+L1RhYnMvUy9TdHJ1Y3RQYXJlbnRzIDA+Pg0KZW5kb2JqDQo0IDAgb2JqDQo8PC9GaWx0ZXIvRmxhdGVEZWNvZGUvTGVuZ3RoIDc3Mjc+Pg0Kc3RyZWFtDQp4nL09a48bN5LfDfg/6D4cIC1u2s138xAEcGzH8V7ieGMne7jdxUHxTOxJ7JEzHucB3I+/Kj5arSar2epuycZoNBKb9SDrRRaLqwcvVp999uCbR88er+rPP1998fjRqq6MtJavfr9/78HTl2r15uP9e3XFV0/v31ux1c"
}
'

{
  "success": true,
  "message": "Payroll tax exemption for company added successfully."
}

Payroll

addPayrollTaxExemption

Used to add a tax exemption to prevent tax withholding for particular employer and employee taxes

What it does

Prevents employee or employer taxes being calculated and withheld when the employee or employer is exempt from a specific tax
Allows file upload to prove the employee or employer is exempt for compliance for High RIsk taxes
Can be used to add exemptions to companies or to employees by adding userId

Notes:

Use the getTaxExemptionNames to retrieve the taxExemptions that can be applied to an employee or company
When getTaxExemptionNames returns a taxName with ExemptionStatus: High Risk supporting documentation must be added
ExemptConfirmation is a legal confirmation that the details provided regarding the employee or employers tax exemption are correct and accurate
The taxName must be applicable to the employee or the employer (federal and state) to be added as an exemption
exemptionEffectiveStartDate must be today or a future date

POST

payroll#addPayrollTaxExemption

addPayrollTaxExemption

curl --request POST \
  --url 'https://sandbox.rollfi.xyz/payroll#addPayrollTaxExemption' \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "method": "addPayrollTaxExemption",
  "companyId": "ECF1B47E-108F-45C0-A520-6A128A727B04",
  "userId": "33820169-85C2-482A-BCCF-B2281419E96E",
  "taxName": "WA - State paid family medical leave ER",
  "exemptionEffectiveStartDate": "2026-02-30",
  "exemptionEffectiveEndDate": "2025-12-31",
  "exemptReason": "Employer claimed exempt on W-4",
  "exemptConfirmation": true,
  "fileName": "tax.pdf",
  "fileBase64": "JVBERi0xLjcNCiW1tbW1DQoxIDAgb2JqDQo8PC9UeXBlL0NhdGFsb2cvUGFnZXMgMiAwIFIvTGFuZyhlbikgL1N0cnVjdFRyZWVSb290IDIyIDAgUi9NYXJrSW5mbzw8L01hcmtlZCB0cnVlPj4vTWV0YWRhdGEgMTk3IDAgUi9WaWV3ZXJQcmVmZXJlbmNlcyAxOTggMCBSPj4NCmVuZG9iag0KMiAwIG9iag0KPDwvVHlwZS9QYWdlcy9Db3VudCAxL0tpZHNbIDMgMCBSXSA+Pg0KZW5kb2JqDQozIDAgb2JqDQo8PC9UeXBlL1BhZ2UvUGFyZW50IDIgMCBSL1Jlc291cmNlczw8L0V4dEdTdGF0ZTw8L0dTNSA1IDAgUi9HUzggOCAwIFI+Pi9YT2JqZWN0PDwvSW1hZ2U2IDYgMCBSPj4vRm9udDw8L0YxIDkgMCBSL0YyIDExIDAgUi9GMyAxMyAwIFIvRjQgMTUgMCBSPj4vUHJvY1NldFsvUERGL1RleHQvSW1hZ2VCL0ltYWdlQy9JbWFnZUldID4+L0Fubm90c1sgMjAgMCBSXSAvTWVkaWFCb3hbIDAgMCA2MTIgNzkyXSAvQ29udGVudHMgNCAwIFIvR3JvdXA8PC9UeXBlL0dyb3VwL1MvVHJhbnNwYXJlbmN5L0NTL0RldmljZVJHQj4+L1RhYnMvUy9TdHJ1Y3RQYXJlbnRzIDA+Pg0KZW5kb2JqDQo0IDAgb2JqDQo8PC9GaWx0ZXIvRmxhdGVEZWNvZGUvTGVuZ3RoIDc3Mjc+Pg0Kc3RyZWFtDQp4nL09a48bN5LfDfg/6D4cIC1u2s138xAEcGzH8V7ieGMne7jdxUHxTOxJ7JEzHucB3I+/Kj5arSar2epuycZoNBKb9SDrRRaLqwcvVp999uCbR88er+rPP1998fjRqq6MtJavfr9/78HTl2r15uP9e3XFV0/v31ux1c"
}
'

{
  "success": true,
  "message": "Payroll tax exemption for company added successfully."
}

Authorizations

Authorization

string

header

required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json

method

string

required

companyId

string

required

taxName

string

required

exemptionEffectiveStartDate

string

required

exemptionEffectiveEndDate

string

required

exemptReason

string

required

exemptConfirmation

boolean

required

userId

string

fileName

string

fileBase64

string

Response

success

boolean

required

message

string

required

importPayrollHistory updatePayrollTaxExemption

API Reference

Authorizations

Body

Response