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

---

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

⚠️ 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

1

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"
  }
}
'

200

1

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

200

application/json

paySchedule · object · required

Show child attributes