Update payroll settings

curl --request PATCH \
  --url https://api.panoflow.io/v1/payroll/settings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "pay_day": {
    "type": "last_working_day"
  }
}
'

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({pay_day: {type: 'last_working_day'}})
};

fetch('https://api.panoflow.io/v1/payroll/settings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.panoflow.io/v1/payroll/settings"

payload = { "pay_day": { "type": "last_working_day" } }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

{
  "object": "payroll_settings",
  "updated_at": "2026-10-27T08:41:00Z",
  "pay_day": {
    "type": "day_of_month",
    "day": 25
  },
  "email_payslips": true,
  "remind_before_pay_day": true,
  "auto_pay_when_approved": true,
  "second_approval_threshold": {
    "amount": 45000000,
    "currency": "NGN"
  },
  "source_account": {
    "id": "<string>",
    "name": "<string>",
    "account_number": "8012457739"
  },
  "second_approver": {
    "membership_id": "<string>",
    "name": "<string>",
    "role": "<string>"
  },
  "top_up_account": {
    "id": "<string>",
    "name": "<string>",
    "account_number": "8012457739"
  },
  "narration_format": "<string>",
  "approve_by_time": "<string>"
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

Payroll settings

Update payroll settings

Changing second_approver_membership_id or source_account_id changes who can approve or where salaries are paid from, so it needs X-Step-Up-Token (403 step_up_required without it) and owner role. Other fields do not. A changed second approver applies to runs not yet approved; a run in pending_approval keeps the approver it was sent to.

A closed source account is 403 account_closed; a second approver whose role can’t approve payments is 403 role_not_permitted.

Error codes: invalid_api_key, parameter_invalid, parameter_missing, resource_not_found, role_not_permitted, scope_missing, step_up_required, csrf_token_invalid, account_closed, rate_limited.

PATCH

payroll

settings

Update payroll settings

curl --request PATCH \
  --url https://api.panoflow.io/v1/payroll/settings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "pay_day": {
    "type": "last_working_day"
  }
}
'

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({pay_day: {type: 'last_working_day'}})
};

fetch('https://api.panoflow.io/v1/payroll/settings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.panoflow.io/v1/payroll/settings"

payload = { "pay_day": { "type": "last_working_day" } }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

{
  "object": "payroll_settings",
  "updated_at": "2026-10-27T08:41:00Z",
  "pay_day": {
    "type": "day_of_month",
    "day": 25
  },
  "email_payslips": true,
  "remind_before_pay_day": true,
  "auto_pay_when_approved": true,
  "second_approval_threshold": {
    "amount": 45000000,
    "currency": "NGN"
  },
  "source_account": {
    "id": "<string>",
    "name": "<string>",
    "account_number": "8012457739"
  },
  "second_approver": {
    "membership_id": "<string>",
    "name": "<string>",
    "role": "<string>"
  },
  "top_up_account": {
    "id": "<string>",
    "name": "<string>",
    "account_number": "8012457739"
  },
  "narration_format": "<string>",
  "approve_by_time": "<string>"
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

Authorizations

Authorization

string

header

required

Server API key, scoped. pk_test_ keys hit the sandbox tenant.

Headers

X-Step-Up-Token

string

Required when changing the second approver or the source account (see description).

X-Request-Id

string

Optional client correlation id, up to 128 characters. It is not echoed: the response's X-Request-Id is always our own req_… id. We log your value with the request as client_request_id, so support can find a request by either id. A longer value is refused with 400 parameter_invalid.

Maximum string length: 128

Body

application/json

pay_day

object

When runs pay. If it falls on a weekend or public holiday, the working day before.

Show child attributes

email_payslips

boolean

Email payslips on pay day.

remind_before_pay_day

boolean

Remind 3 days before.

auto_pay_when_approved

boolean

Pay automatically if approved.

second_approver_membership_id

string

mem_… with a role that can approve payments. Needs step-up.

source_account_id

string

acc_…. Needs step-up.

Response

The updated settings.

Payroll settings for the business.

object

string

required

Always payroll_settings.

Allowed value: "payroll_settings"

updated_at

string<date-time>

required

RFC 3339, UTC.

Example:

"2026-10-27T08:41:00Z"

pay_day

object

required

When runs pay. If it falls on a weekend or public holiday, the working day before.

Show child attributes

email_payslips

boolean

required

Email each person a PDF payslip on pay day.

remind_before_pay_day

boolean

required

Remind approvers 3 days before pay day and warn if the source account is short.

auto_pay_when_approved

boolean

required

Scheduled runs pay out on pay day without anyone calling executePayRun.

second_approval_threshold

object

required

Runs with net pay above this need a second approver. Set by the business's approval limits (read-only here).

Show child attributes

source_account

object

required

Account runs are paid from (Naira · Payroll).

Show child attributes

second_approver

object

Team member who approves runs over the threshold.

Show child attributes

top_up_account

object

Account suggested for topping up the source account (Naira · Main).

Show child attributes

narration_format

string

Narration on salary transfers; {Mon} and {YYYY} are replaced per run ("Salary Nov 2026"). Read-only.

approve_by_time

string

Local time (Africa/Lagos) on the day before pay day by which a run must be approved to pay on pay day.

Pattern: ^\d{2}:\d{2}$

Accounts & transactions

Payments

Collections

Payroll

Approvals

Webhooks & events

OAuth

Update payroll settings

Authorizations

Headers

Body

Response