Skip to main content
POST
/
business_presets
Create a business preset
curl --request POST \
  --url https://sandbox.nmbr.co/services/payroll/business_presets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "business_entity_id": "<id>",
  "type": "earning",
  "subtype": "bonus_discretionary",
  "name": "Business Preset 08a620c8-1d8a-3f0c-9475-963b2e8a0d49",
  "title": "Christmas Bonus"
}
'
{
  "id": "<id>",
  "object": "business_preset",
  "data": {
    "business_entity": {
      "id": "<id>",
      "object": "business_entity",
      "links": {
        "self": "/business_entities/<id>"
      }
    },
    "name": "Business Preset 08a620c8-1d8a-3f0c-9475-963b2e8a0d49",
    "name_translations": null,
    "name_translated": "Business Preset 08a620c8-1d8a-3f0c-9475-963b2e8a0d49",
    "title": "Christmas Bonus",
    "title_translations": null,
    "title_translated": "Christmas Bonus",
    "type": "earning",
    "subtype": "bonus_discretionary",
    "remittance_account": null,
    "is_managed": false,
    "expense_accounting_code": null,
    "liability_accounting_code": null,
    "income_basis": null,
    "income_includes": [],
    "external_ref": null,
    "created_at": "2026-01-01T00:00:00.000000Z",
    "updated_at": "2026-01-01T00:00:00.000000Z"
  },
  "links": {
    "self": "/business_presets/<id>"
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
business_entity_id
string
required
type
enum<string>
required
Available options:
allowance,
deduction,
earning,
employee_benefit,
employer_benefit,
reimbursement
name
string
required
Maximum string length: 255
subtype
enum<string>
Available options:
bonus_discretionary,
bonus_non_discretionary,
bonus_non_taxable,
commission,
commission_periodic,
commission_self_employed,
death_benefit,
gift_cash,
gratuity,
in_lieu_wages,
income_replacement_indemnity_non_taxable,
income_replacement_indemnity_taxable,
invoice_payment,
invoice_sales_tax,
leave_bereavement,
leave_domestic_and_sexual_violence,
leave_general,
leave_paternity,
leave_personal,
leave_sick,
leave_voting,
leave_wedding,
overtime,
parental_top_up_insurable,
parental_top_up_non_insurable,
pension,
retiring_allowance,
retiring_allowance_eligible,
retroactive_pay,
retroactive_pay_increase,
salary,
salary_continuance,
severance_pay,
statutory_holiday_pay,
supplemental_unemployment,
vacation_accrual_adjustment,
vacation_pay,
vacation_pay_employee_terminated,
vacation_pay_no_time_taken,
vacation_pay_time_taken,
wage
name_translations
object

Optional translations for the name property.

title
string | null
Maximum string length: 255
title_translations
object

Optional translations for the title property.

remittance_account_id
string
expense_accounting_code_id
string
liability_accounting_code_id
string
income_basis
enum<string>
Available options:
all_earnings,
none,
regular_earnings,
total_income
income_includes
object[]
external_ref
string
Maximum string length: 255

Response

201 - application/json

Created

id
string
read-only

The unique identifier of the object in Nmbr.

object
string
read-only

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

data
Business Preset · object