Skip to main content
PUT
/
business_presets
/
{business_preset}
Update a business preset
curl --request PUT \
  --url https://sandbox.nmbr.co/services/payroll/business_presets/{business_preset} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Holiday 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": "Holiday Bonus",
    "title_translations": null,
    "title_translated": "Holiday 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.

Path Parameters

business_preset
string
required

Body

application/json
keep_existing_values
enum<string>

Controls which preset values should be kept or updated on entities created from the preset when that value is updated on the preset. Defaults to none.

Available options:
all,
in_sync,
non_null,
none,
out_of_sync
name
string
Maximum string length: 255
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

200 - application/json

OK

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