Creates a new pay schedule for the business.

Request

POST https://apimy.yourpayroll.io/api/v2/business/{businessId}/payschedule

Path parameters

Parameter name Value Description Additional
businessId string Required

Request body

The request body takes a complete PayScheduleModel resource, containing the following writable properties:

{
    "defaultFinaliseSettings": {
        "exportJournals": "string",
        "exportJournalsDay": "int32",
        "exportJournalsTimeOfDay": "string",
        "exportJournalsTimeline": "string",
        "lodgePayRun": "string",
        "lodgePayRunDay": "int32",
        "lodgePayRunTimeOfDay": "string",
        "lodgePayRunTimeline": "string",
        "publishPaySlips": "string",
        "publishPaySlipsDay": "int32",
        "publishPaySlipsTimeOfDay": "string",
        "publishPaySlipsTimeline": "string",
        "reportPacksToRun": [
            "int32"
        ],
        "runReportPacks": "string",
        "runReportPacksDay": "int32",
        "runReportPacksTimeOfDay": "string",
        "runReportPacksTimeline": "string",
        "submitToPensionSync": "string",
        "submitToPensionSyncDay": "int32",
        "submitToPensionSyncTimeOfDay": "string",
        "submitToPensionSyncTimeline": "string",
        "suppressNotifications": "boolean"
    },
    "employeeSelectionStrategy": "string",
    "equalMonthlyPayments": "boolean",
    "externalId": "string",
    "id": "int32",
    "ignoredPayRunWarnings": [
        "int32"
    ],
    "lastDatePaid": "date-time",
    "lastPayRun": "date-time",
    "locations": [
        "int32"
    ],
    "name": "string",
    "payScheduleApprovalSettings": {
        "approversToNotify": [
            "string"
        ],
        "notificationSubject": "string",
        "notificationTemplate": "string",
        "reminderDay": "int32",
        "reminderSubject": "string",
        "reminderTemplate": "string",
        "requireApproval": "boolean",
        "sendReminder": "boolean"
    },
    "source": "string"
}

Properties

Name Type Description
defaultFinaliseSettings object PayRunFinaliseDefaultSettingsModel
defaultFinaliseSettings.exportJournals string PayRunFinaliseActionPreference

Possible values are:

  • Manual
  • Immediate
  • Scheduled
defaultFinaliseSettings.exportJournalsDay int32 Int32
defaultFinaliseSettings.exportJournalsTimeOfDay string Nullable
defaultFinaliseSettings.exportJournalsTimeline string PayRunFinaliseActionTimeline

Possible values are:

  • Before
  • After
  • On
defaultFinaliseSettings.lodgePayRun string PayRunFinaliseActionPreference

Possible values are:

  • Manual
  • Immediate
  • Scheduled
defaultFinaliseSettings.lodgePayRunDay int32 Int32
defaultFinaliseSettings.lodgePayRunTimeOfDay string Nullable
defaultFinaliseSettings.lodgePayRunTimeline string PayRunFinaliseActionTimeline

Possible values are:

  • Before
  • After
  • On
defaultFinaliseSettings.publishPaySlips string PayRunFinaliseActionPreference

Possible values are:

  • Manual
  • Immediate
  • Scheduled
defaultFinaliseSettings.publishPaySlipsDay int32 Int32
defaultFinaliseSettings.publishPaySlipsTimeOfDay string Nullable
defaultFinaliseSettings.publishPaySlipsTimeline string PayRunFinaliseActionTimeline

Possible values are:

  • Before
  • After
  • On
defaultFinaliseSettings.reportPacksToRun[] array of int32
defaultFinaliseSettings.runReportPacks string PayRunFinaliseActionPreference

Possible values are:

  • Manual
  • Immediate
  • Scheduled
defaultFinaliseSettings.runReportPacksDay int32 Int32
defaultFinaliseSettings.runReportPacksTimeOfDay string Nullable
defaultFinaliseSettings.runReportPacksTimeline string PayRunFinaliseActionTimeline

Possible values are:

  • Before
  • After
  • On
defaultFinaliseSettings.submitToPensionSync string PayRunFinaliseActionPreference

Possible values are:

  • Manual
  • Immediate
  • Scheduled
defaultFinaliseSettings.submitToPensionSyncDay int32 Int32
defaultFinaliseSettings.submitToPensionSyncTimeOfDay string Nullable
defaultFinaliseSettings.submitToPensionSyncTimeline string PayRunFinaliseActionTimeline

Possible values are:

  • Before
  • After
  • On
defaultFinaliseSettings.suppressNotifications boolean Boolean
employeeSelectionStrategy string Nullable

Possible values are:

  • None
  • PayRunDefault
  • TimesheetLocations
  • PayRunDefaultWithTimesheets
equalMonthlyPayments boolean Boolean
externalId string String
id int32 Int32
ignoredPayRunWarnings[] array of int32
lastDatePaid date-time Nullable
lastPayRun date-time Nullable
locations[] array of int32
name string String
payScheduleApprovalSettings object PayScheduleApprovalSettingsModel
payScheduleApprovalSettings.approversToNotify[] array of string
payScheduleApprovalSettings.notificationSubject string String
payScheduleApprovalSettings.notificationTemplate string String
payScheduleApprovalSettings.reminderDay int32 Int32
payScheduleApprovalSettings.reminderSubject string String
payScheduleApprovalSettings.reminderTemplate string String
payScheduleApprovalSettings.requireApproval boolean Boolean
payScheduleApprovalSettings.sendReminder boolean Boolean
source string String

Response

The following HTTP status codes may be returned, optionally with a response resource.

Status code Description Resource
200 OK

OK

PayScheduleModel