---
title: "Create an employer statutory withholding line item"
method: POST
path: "/employer_statutory_withholding_line_items"
tags: ["Employer Statutory Withholding Line Items"]
---

# Create an employer statutory withholding line item

`POST /employer_statutory_withholding_line_items`

Only available on correction and historical payrolls.

## Request body

- object
  - `pay_stub_id` string, required
  - `business_preset_id` string
  - `employer_statutory_withholding_type` 'cpp' | 'cpp_2' | 'eht' | 'ei' | 'qpip' | 'qpp' | 'qpp_2' | 'wcb' — The type of employer statutory withholding for this line item. Must be present when `business_preset_id` is either empty or not set.
  - `custom_amount` number — An override for `managed_amount`. When set, `amount` reflects this value instead of `managed_amount`.
  - `title` string, nullable
  - `title_translations` Translations, nullable
    - `en` string
    - `fr` string
  - `remittance_account_id` string
  - `expense_accounting_code_id` string
  - `custom_expense_accounting_code_id` string
  - `liability_accounting_code_id` string
  - `custom_liability_accounting_code_id` string
  - `external_ref` string

## Response `201`

Created

- object
  - `id` string — The unique identifier of the object in Nmbr.
  - `object` string — The type of the object in Nmbr (`"employer_statutory_withholding_line_item"`).
  - `data` EmployerStatutoryWithholdingLineItem
    - `pay_stub` object
      - `id` string — The unique identifier of the object in Nmbr.
      - `object` string — The type of the object in Nmbr (`"pay_stub"`).
    - `line_item_type` string, nullable
    - `is_system` boolean — Whether this line item was generated automatically by the payroll engine.
    - `is_managed` boolean — Always `true`. Employer statutory withholding line items are fully managed by the payroll engine and cannot be created, updated, or deleted.
    - `amount` number, nullable — The effective amount for this line item. Returns `custom_amount` if set, otherwise `managed_amount`. Read-only.
    - `custom_amount` number, nullable — An override for `managed_amount`. When set, `amount` reflects this value instead of `managed_amount`.
    - `managed_amount` number — The withholding amount calculated by the payroll engine. Read-only; set `custom_amount` to override.
    - `employer_statutory_withholding_type` object — The type of employer statutory withholding for this line item.
      - `id` string — The unique identifier of the object in Nmbr.
      - `object` string — The type of the object in Nmbr (`"employer_statutory_withholding_type"`).
      - `data` EmployerStatutoryWithholdingType
        - `type` string, nullable — The string identifier for this employer statutory withholding type.
        - `label` string, nullable — The human-readable display name for this employer statutory withholding type.
    - `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.
    - `remittance_account` object
      - `id` string — The unique identifier of the object in Nmbr.
      - `object` string — The type of the object in Nmbr (`"remittance_account"`).
    - `source_adjustment` unknown
    - `business_preset` object
      - `id` string — The unique identifier of the object in Nmbr.
      - `object` string — The type of the object in Nmbr (`"business_preset"`).
    - `expense_accounting_code` unknown
    - `managed_expense_accounting_code` unknown
    - `custom_expense_accounting_code` unknown
    - `liability_accounting_code` unknown
    - `managed_liability_accounting_code` unknown
    - `custom_liability_accounting_code` unknown
    - `component_settings` object, nullable — Settings specific to the Nmbr component.
      - `attributes_locked` boolean — Whether the line item is locked and cannot be edited in the component.
    - `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/revisions/c2532d856ea2/schema)