---
title: "Update a business preset"
method: PUT
path: "/business_presets/{business_preset}"
tags: ["Business Presets"]
---

# Update a business preset

`PUT /business_presets/{business_preset}`

## Path parameters

- `business_preset` string, required

## Request body

- object
  - `keep_existing_values` 'all' | 'in_sync' | 'non_null' | 'none' | 'out_of_sync' — 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`.
  - `name` string
  - `name_translations` Translations, nullable
    - `en` string
    - `fr` string
  - `title` string, nullable
  - `title_translations` Translations, nullable
    - `en` string
    - `fr` string
  - `remittance_account_id` string
  - `expense_accounting_code_id` string
  - `liability_accounting_code_id` string
  - `income_basis` 'all_earnings' | 'none' | 'regular_earnings' | 'total_income'
  - `income_includes` object[]
    - `type` 'allowance' | 'earning' | 'employer_benefit' | 'reimbursement'
    - `subtype` string
  - `external_ref` string

## Response `200`

OK

- object
  - `id` string — The unique identifier of the object in Nmbr.
  - `object` string — The type of the object in Nmbr (`"business_preset"`).
  - `data` BusinessPreset
    - `business_entity` object
      - `id` string — The unique identifier of the object in Nmbr.
      - `object` string — The type of the object in Nmbr (`"business_entity"`).
    - `name` string
    - `name_translations` Translations, nullable
      - `en` string
      - `fr` string
    - `name_translated` string — The translation of the `name` property for the request locale. Computed using the values in `name` and `name_translations` and the value of the request's `Accept-Language` header.
    - `title` string, nullable
    - `title_translations` Translations, nullable
      - `en` string
      - `fr` string
    - `title_translated` string — The translation of the `title` property for the request locale. Computed using the values in `title` and `title_translations` and the value of the request's `Accept-Language` header.
    - `type` string
    - `subtype` string, nullable
    - `remittance_account` unknown
    - `is_managed` boolean — If true, this is a default Business Preset and can not be deleted, `title` and `remittance_account` may be set.
    - `expense_accounting_code` unknown
    - `liability_accounting_code` unknown
    - `income_basis` 'all_earnings' | 'none' | 'regular_earnings' | 'total_income', nullable
    - `income_includes` object, nullable
    - `external_ref` string, nullable — A reference to the object in an external system, e.g. the primary key of the object in your application's database. Nmbr doesn't use, validate, parse, or require this value to be unique - it simply stores it for your reference.
    - `created_at` string, dateTime — The date and time the object was created in Nmbr.
    - `updated_at` string, dateTime — The date and time the object was last updated in Nmbr.

---

[API](https://skmtc.net/nmbr/apis/nmbr-api.md) · [All operations](https://skmtc.net/nmbr/apis/nmbr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nmbr/nmbr-api/versions/a0c7a815860f/schema)