v4

latestOpenAPI 3.0.02026-07-314441026.8 MB

Pay Schedules

Create a pay schedule

post/pay_schedules

Request body

business_entity_idstring required

titlestring required

pay_frequency'bi-weekly' | 'custom' | 'monthly' | 'semi-monthly' | 'weekly' required

The frequency at which Payrolls are processed. Use custom for non-standard schedules where the number of pay periods per year is specified manually.

anchor_pay_datestring date

The pay date of the anchor pay period. Together with anchor_end_of_pay_period, this establishes the pattern from which all future pay dates are calculated.

Date must not be more than one year before now.

anchor_start_of_pay_periodstring date

The start date of the anchor pay period. Only required for semi-monthly pay schedules when anchor_end_of_pay_period is not the 15th or the last day of the month. For standard configurations it is derived automatically and does not need to be supplied.

Required for semi-monthly pay schedules when anchor_end_of_pay_period is not the 15th or the last day of the month.

anchor_end_of_pay_periodstring date

The end date of the anchor pay period. Together with anchor_pay_date, this defines the length and pattern of all future pay periods.

Date must not be more than one year before now.

generate_payrolls_fromstring date

Only available in preview mode. When set, Payrolls are generated starting from this date rather than the default, allowing historical Payrolls to be created before the current date.

Available in Preview mode, must be on or after anchor_pay_date. Allows for creation of Payrolls before the current date.

day_1integer

For monthly pay schedules, the day of the month on which pay is issued. For semi-monthly pay schedules, the first of two pay days per month.

Required for monthly and semi-monthly pay schedules; must be null for other frequencies. For semi-monthly pay schedules, valid (day_1, day_2) pairs are (16, 1), (15, -1), and (15, 31).

day_2integer

For semi-monthly pay schedules, the second of two pay days per month.

Required for semi-monthly pay schedules; must be null for other frequencies. For semi-monthly pay schedules, valid (day_1, day_2) pairs are (16, 1), (15, -1), and (15, 31).

pay_day_movement_setting'inherit' | 'next_business_day' | 'previous_business_day'

The pay schedule-level setting for how pay dates are adjusted when they fall on a weekend or bank holiday. If set to inherit, the Business Entity's setting is used.

send_empty_pay_stubsboolean

Whether Pay Stubs are generated for employees with no earnings in a given pay period.

custom_pay_periods_per_yearinteger

When pay_frequency is custom, the number of pay periods per year.

external_refstring

Response

Created

idstring

The unique identifier of the object in Nmbr.

objectstring

The type of the object in Nmbr ("pay_schedule").