curl --request POST \
  --url https://sandbox.rollfi.xyz/payroll/addPaySchedule \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "method": "addPaySchedule",
  "paySchedule": {
    "companyId": "AFB94AFD-D9EE-4018-A718-304D43702C9C",
    "workerType": "1099-NEC",
    "standardWorkingHours": 8,
    "compensationFrequency": "BiWeekly",
    "payBeginDate": "2025-07-31",
    "payDate": "2025-08-04",
    "paymentMode": "Self-Initiated"
  }
}
'

{
  "paySchedule": {
    "payScheduleId": "8457D59C-20B9-4B01-8B2F-7BD60C700DEB",
    "status": "Active",
    "message": "The PaySchedule  for Blanda's LLC has been added successfully"
  }
}

Payroll

addPaySchedule

Sets up payment frequency and schedule for company employees.

🔹For more in depth details on how to set up a paySchedule, take a look at the Payroll Guide

Compensation Frequencies

Frequency	Use Case
Weekly	Hourly workers, high turnover
BiWeekly	Most common for salaried
SemiMonthly	15th and last day of month
Monthly	Executive/contractor payments
Quarterly	Sole proprietors/Small business owners

Monthly and Semi-Monthly Schedules

To retrieve pay period startDates and endDates, use the getMonthlySemitMonthlyPaySchedulDates API
The day employees are paid in Monthly and SemiMonthly pay schedules is flexible
For SemiMonthly pay schedules use payDateOptions to set a pay day based on the distance from the payEndDate
For Monthly pay schedules use payDay

Quarterly Schedules

The start and end date of each payPeriod are determined by the payDate in the request
To begin a schedule including the current quarter, the payDate but be on or before Quarter end

⚠️ Warning:

The option field, previously used to determine the payDay for Monthly and SemitMonthly paySchedules will be deprecated soon

Note:

payDate, payDay or payDateOptions are required based on the pay schedule

POST

payroll

addPaySchedule

curl --request POST \
  --url https://sandbox.rollfi.xyz/payroll/addPaySchedule \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "method": "addPaySchedule",
  "paySchedule": {
    "companyId": "AFB94AFD-D9EE-4018-A718-304D43702C9C",
    "workerType": "1099-NEC",
    "standardWorkingHours": 8,
    "compensationFrequency": "BiWeekly",
    "payBeginDate": "2025-07-31",
    "payDate": "2025-08-04",
    "paymentMode": "Self-Initiated"
  }
}
'

{
  "paySchedule": {
    "payScheduleId": "8457D59C-20B9-4B01-8B2F-7BD60C700DEB",
    "status": "Active",
    "message": "The PaySchedule  for Blanda's LLC has been 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

paySchedule

object

required

Show child attributes

Response

paySchedule

object

required

Show child attributes