# Updates a business unit with the specified ID.

This method will update an existing business unit with the specified ID.

Endpoint: PUT /businessUnits/{tenantId}/{id}
Version: v1-2025-04-18
Security: knox-authorizer

## Path parameters:

  - `tenantId` (string, required)
    The id of the tenant being accessed.

  - `id` (string, required)
    The ID of the business unit to update.

## Request fields (application/json):

  - `accounting_method` (string)
    The accounting method for generating subledger entries
    Enum: "accrual", "cash"

  - `ar_gl_account_id` (string)
    The default A/R account

  - `automatic_batch_download_options` (object, required)

  - `automatic_batch_download_options.accounting_integration_account_id` (string, required)
    The ID of the accounting integration service

  - `automatic_batch_download_options.accounting_integration_service` (string, required)
    Enum: "integration-qbo-accounts"

  - `bad_debts_expense_gl_account_id` (string)
    The default A/R account

  - `base_currency_code` (string, required)
    The base currency for the business unit

  - `base_currency_symbol` (string)
    The base symbol for the business unit

  - `batch_download_method` (string, required)
    Enum: "batch-level summary", "detail", "summary"

  - `cogs_expense_gl_account_id` (string)
    The default COGS expense account

  - `currency_trading_gl_account_id` (string)
    The default A/R account

  - `custom_field_values` (array)

  - `custom_field_values.boolean_value` (boolean)
    The boolean value

  - `custom_field_values.custom_field_id` (string)
    The unique identifier of the custom field

  - `custom_field_values.file_url_value` (string)
    The pointer to a file value

  - `custom_field_values.list_value` (array)
    The list value

  - `custom_field_values.numeric_value` (number)
    The numeric value

  - `custom_field_values.string_value` (string)
    The string value of the custom field

  - `custom_field_values.table_value` (array)
    A list of objects (a table)

  - `default_write_off_method` (string, required)
    Enum: "allowance", "direct"

  - `deferred_revenue_gl_account_id` (string)
    The default A/R account

  - `description` (string)
    Any descriptive information about the business unit

  - `download_template_id` (string)
    The optional template to use to format the financial download file

  - `due_to_due_from_entries` (array)

  - `due_to_due_from_entries.accounts_receivable_gl_account_id` (string, required)
    The A/R G/L

  - `due_to_due_from_entries.business_unit_id` (string, required)
    The business unit

  - `due_to_due_from_entries.liability_gl_account_id` (string, required)
    The liability G/L account ID

  - `enable_automatic_batch_downloads` (boolean)
    When enabled, batches are automatically synced with users accounting software

  - `enable_multi_currency` (boolean)
    Whether or not multi-currency is turned on for this business unit

  - `financial_software_package` (string)
    Enum: "great plains", "netsuite", "other", "peachtree", "quickbooks", "quickbooks online", "sage intacct"

  - `id` (string, required)
    The unique, string identifier of this business unit

  - `inventory_costing_method` (string, required)
    Enum: "do not calculate", "fifo", "lifo"

  - `inventory_gl_account_id` (string)
    The default A/R account

  - `invoice_template_id` (string)
    Teh default invoice template to use for printing invoices

  - `is_active` (boolean)
    Whether or not this business unit is active

  - `missing_product_revenue_gl_account_id` (string)
    The G/L account for missing products

  - `name` (string, required)
    The name of the business unit

  - `overpayment_liability_gl_account_id` (string)
    The default A/R account

  - `payment_receipt_email` (object)

  - `payment_receipt_email.bcc` (string)
    Anyone that should be bcc'ed on the email

  - `payment_receipt_email.body` (string, required)
    The email body

  - `payment_receipt_email.cc` (string)
    Anyone that should be cc'ed on the email

  - `payment_receipt_email.from` (string)
    From email address

  - `payment_receipt_email.from_name` (string)
    From name

  - `payment_receipt_email.reply_to` (string)
    The reply to

  - `payment_receipt_email.subject` (string, required)
    The email subject

  - `payment_receipt_template_id` (string)
    Teh default payment template to use for printing payment receipts

  - `priority` (number)
    A priority number that determines how this is displayed; lower numbers indicate higher priority

  - `quickbooks_online_account_id` (string)
    The quickbooks online account tied to the business unit

  - `refund_receipt_email` (object)

  - `refund_receipt_template_id` (string)
    Teh default template to use for printing refund receipts

  - `start_of_fiscal_year` (integer, required)
    The starting month of the fiscal year, between 1-12

  - `store_credit_gl_account_id` (string)
    The default A/R account

  - `supported_currencies` (array, required)

  - `supported_currencies.currency_code` (string, required)
    Enum: "AED", "AFN", "ALL", "AMD", "ANG", "AOA", "ARS", "AUD", "AWG", "AZN", "BAM", "BBD", "BDT", "BGN", "BHD", "BIF", "BMD", "BND", "BOB", "BRL", "BSD", "BTN", "BWP", "BYR", "BZD", "CAD", "CDF", "CHF", "CLP", "CNY", "COP", "CRC", "CUC", "CVE", "CZK", "DJF", "DKK", "DOP", "DZD", "EEK", "EGP", "ERN", "ETB", "EUR", "FJD", "FKP", "GBP", "GEL", "GHS", "GIP", "GMD", "GNF", "GQE", "GTQ", "GYD", "HKD", "HNL", "HRK", "HTG", "HUF", "IDR", "ILS", "INR", "IQD", "IRR", "ISK", "JMD", "JOD", "JPY", "KES", "KGS", "KHR", "KMF", "KPW", "KRW", "KWD", "KYD", "KZT", "LAK", "LBP", "LKR", "LRD", "LSL", "LTL", "LVL", "LYD", "MAD", "MDL", "MGA", "MKD", "MMK", "MNT", "MOP", "MRO", "MUR", "MVR", "MWK", "MXN", "MYR", "MZM", "NAD", "NGN", "NIO", "NOK", "NPR", "NZD", "OMR", "PAB", "PEN", "PGK", "PHP", "PKR", "PLN", "PYG", "QAR", "RON", "RSD", "RUB", "SAR", "SBD", "SCR", "SDG", "SEK", "SGD", "SHP", "SLL", "SOS", "SRD", "SYP", "SZL", "THB", "TJS", "TMT", "TND", "TRY", "TTD", "TWD", "TZS", "UAH", "UGX", "USD", "UYU", "UZS", "VEB", "VND", "VUV", "WST", "XAF", "XCD", "XDR", "XOF", "XPF", "YER", "ZAR", "ZMK", "ZWR"

  - `sys_bulk_load_at` (string)
    If this record was loaded via bulk, the timestamp when the record was processed

  - `sys_bulk_load_id` (string)
    If this record was loaded via bulk, the ID of the bulk load process

  - `sys_bulk_load_pk` (string)
    If this record was loaded via bulk, the tenant and key of the bulk load process used as a partition key

  - `sys_bulk_load_record_no` (number)
    If this record was loaded via bulk, the record number in the source file

  - `sys_bulk_load_source_file` (string)
    If this record was loaded via bulk, the source file

  - `sys_calculated_field_error` (string)
    The error associated with the calculated field

  - `sys_calculated_field_errors` (array)

  - `sys_calculated_field_errors.error` (string)

  - `sys_calculated_field_errors.field` (string)

  - `sys_configuration_snapshot_id` (string)
    If a snapshot was restored/applies to this record, the ID of the snapshot

  - `sys_created_at` (string, required)
    The date/time that this record was created, expressed in ISO-8601 date format

  - `sys_created_by_id` (string, required)
    The ID of the user that created this record

  - `sys_deleted_by_id` (string)
    The ID of the user that deleted (or last tried to delete) this object

  - `sys_directive` (string)
    Means for passing directive information into an object processing logic

  - `sys_external_id` (string)
    The ID that a record has from an external system or data import

  - `sys_has_files_in_s3` (boolean)
    If true, this record has files in S3. If false, it doesnt, so no need to hit S3 upon deletion

  - `sys_last_bulk_data_operation_id` (string)
    If this record was last touched by a bulk data operation, the ID of that operation

  - `sys_last_bulk_data_operation_sys_version` (string)
    If this record was last touched by a bulk data operation, the sys_version at the time of that operation

  - `sys_last_modified_at` (string, required)
    The date/time that this record record was last modified, expressed in ISO-8601 date format

  - `sys_last_modified_by_id` (string, required)
    The ID of the user that last modified this record

  - `sys_last_security_context` (object)
    The security context of the last insert, modify, or delete performed on this item

  - `sys_locked` (boolean)
    If set, this record is locked and cannot be changed via the API

  - `sys_snapshot_base_version` (number)
    The version to use as a base when creating a configuration snapshot; if not set, 1 is used. Helpful when creating a sandbox

  - `sys_version` (number)
    A number representing the version of this record in the database

## Response 200 fields (application/json):

  - `accounting_method` (string)
    The accounting method for generating subledger entries
    Enum: "accrual", "cash"

  - `ar_gl_account_id` (string)
    The default A/R account

  - `automatic_batch_download_options` (object, required)

  - `automatic_batch_download_options.accounting_integration_account_id` (string, required)
    The ID of the accounting integration service

  - `automatic_batch_download_options.accounting_integration_service` (string, required)
    Enum: "integration-qbo-accounts"

  - `bad_debts_expense_gl_account_id` (string)
    The default A/R account

  - `base_currency_code` (string, required)
    The base currency for the business unit

  - `base_currency_symbol` (string)
    The base symbol for the business unit

  - `batch_download_method` (string, required)
    Enum: "batch-level summary", "detail", "summary"

  - `cogs_expense_gl_account_id` (string)
    The default COGS expense account

  - `currency_trading_gl_account_id` (string)
    The default A/R account

  - `custom_field_values` (array)

  - `custom_field_values.boolean_value` (boolean)
    The boolean value

  - `custom_field_values.custom_field_id` (string)
    The unique identifier of the custom field

  - `custom_field_values.file_url_value` (string)
    The pointer to a file value

  - `custom_field_values.list_value` (array)
    The list value

  - `custom_field_values.numeric_value` (number)
    The numeric value

  - `custom_field_values.string_value` (string)
    The string value of the custom field

  - `custom_field_values.table_value` (array)
    A list of objects (a table)

  - `default_write_off_method` (string, required)
    Enum: "allowance", "direct"

  - `deferred_revenue_gl_account_id` (string)
    The default A/R account

  - `description` (string)
    Any descriptive information about the business unit

  - `download_template_id` (string)
    The optional template to use to format the financial download file

  - `due_to_due_from_entries` (array)

  - `due_to_due_from_entries.accounts_receivable_gl_account_id` (string, required)
    The A/R G/L

  - `due_to_due_from_entries.business_unit_id` (string, required)
    The business unit

  - `due_to_due_from_entries.liability_gl_account_id` (string, required)
    The liability G/L account ID

  - `enable_automatic_batch_downloads` (boolean)
    When enabled, batches are automatically synced with users accounting software

  - `enable_multi_currency` (boolean)
    Whether or not multi-currency is turned on for this business unit

  - `financial_software_package` (string)
    Enum: "great plains", "netsuite", "other", "peachtree", "quickbooks", "quickbooks online", "sage intacct"

  - `id` (string, required)
    The unique, string identifier of this business unit

  - `inventory_costing_method` (string, required)
    Enum: "do not calculate", "fifo", "lifo"

  - `inventory_gl_account_id` (string)
    The default A/R account

  - `invoice_template_id` (string)
    Teh default invoice template to use for printing invoices

  - `is_active` (boolean)
    Whether or not this business unit is active

  - `missing_product_revenue_gl_account_id` (string)
    The G/L account for missing products

  - `name` (string, required)
    The name of the business unit

  - `overpayment_liability_gl_account_id` (string)
    The default A/R account

  - `payment_receipt_email` (object)

  - `payment_receipt_email.bcc` (string)
    Anyone that should be bcc'ed on the email

  - `payment_receipt_email.body` (string, required)
    The email body

  - `payment_receipt_email.cc` (string)
    Anyone that should be cc'ed on the email

  - `payment_receipt_email.from` (string)
    From email address

  - `payment_receipt_email.from_name` (string)
    From name

  - `payment_receipt_email.reply_to` (string)
    The reply to

  - `payment_receipt_email.subject` (string, required)
    The email subject

  - `payment_receipt_template_id` (string)
    Teh default payment template to use for printing payment receipts

  - `priority` (number)
    A priority number that determines how this is displayed; lower numbers indicate higher priority

  - `quickbooks_online_account_id` (string)
    The quickbooks online account tied to the business unit

  - `refund_receipt_email` (object)

  - `refund_receipt_template_id` (string)
    Teh default template to use for printing refund receipts

  - `start_of_fiscal_year` (integer, required)
    The starting month of the fiscal year, between 1-12

  - `store_credit_gl_account_id` (string)
    The default A/R account

  - `supported_currencies` (array, required)

  - `supported_currencies.currency_code` (string, required)
    Enum: "AED", "AFN", "ALL", "AMD", "ANG", "AOA", "ARS", "AUD", "AWG", "AZN", "BAM", "BBD", "BDT", "BGN", "BHD", "BIF", "BMD", "BND", "BOB", "BRL", "BSD", "BTN", "BWP", "BYR", "BZD", "CAD", "CDF", "CHF", "CLP", "CNY", "COP", "CRC", "CUC", "CVE", "CZK", "DJF", "DKK", "DOP", "DZD", "EEK", "EGP", "ERN", "ETB", "EUR", "FJD", "FKP", "GBP", "GEL", "GHS", "GIP", "GMD", "GNF", "GQE", "GTQ", "GYD", "HKD", "HNL", "HRK", "HTG", "HUF", "IDR", "ILS", "INR", "IQD", "IRR", "ISK", "JMD", "JOD", "JPY", "KES", "KGS", "KHR", "KMF", "KPW", "KRW", "KWD", "KYD", "KZT", "LAK", "LBP", "LKR", "LRD", "LSL", "LTL", "LVL", "LYD", "MAD", "MDL", "MGA", "MKD", "MMK", "MNT", "MOP", "MRO", "MUR", "MVR", "MWK", "MXN", "MYR", "MZM", "NAD", "NGN", "NIO", "NOK", "NPR", "NZD", "OMR", "PAB", "PEN", "PGK", "PHP", "PKR", "PLN", "PYG", "QAR", "RON", "RSD", "RUB", "SAR", "SBD", "SCR", "SDG", "SEK", "SGD", "SHP", "SLL", "SOS", "SRD", "SYP", "SZL", "THB", "TJS", "TMT", "TND", "TRY", "TTD", "TWD", "TZS", "UAH", "UGX", "USD", "UYU", "UZS", "VEB", "VND", "VUV", "WST", "XAF", "XCD", "XDR", "XOF", "XPF", "YER", "ZAR", "ZMK", "ZWR"

  - `sys_bulk_load_at` (string)
    If this record was loaded via bulk, the timestamp when the record was processed

  - `sys_bulk_load_id` (string)
    If this record was loaded via bulk, the ID of the bulk load process

  - `sys_bulk_load_pk` (string)
    If this record was loaded via bulk, the tenant and key of the bulk load process used as a partition key

  - `sys_bulk_load_record_no` (number)
    If this record was loaded via bulk, the record number in the source file

  - `sys_bulk_load_source_file` (string)
    If this record was loaded via bulk, the source file

  - `sys_calculated_field_error` (string)
    The error associated with the calculated field

  - `sys_calculated_field_errors` (array)

  - `sys_calculated_field_errors.error` (string)

  - `sys_calculated_field_errors.field` (string)

  - `sys_configuration_snapshot_id` (string)
    If a snapshot was restored/applies to this record, the ID of the snapshot

  - `sys_created_at` (string, required)
    The date/time that this record was created, expressed in ISO-8601 date format

  - `sys_created_by_id` (string, required)
    The ID of the user that created this record

  - `sys_deleted_by_id` (string)
    The ID of the user that deleted (or last tried to delete) this object

  - `sys_directive` (string)
    Means for passing directive information into an object processing logic

  - `sys_external_id` (string)
    The ID that a record has from an external system or data import

  - `sys_has_files_in_s3` (boolean)
    If true, this record has files in S3. If false, it doesnt, so no need to hit S3 upon deletion

  - `sys_last_bulk_data_operation_id` (string)
    If this record was last touched by a bulk data operation, the ID of that operation

  - `sys_last_bulk_data_operation_sys_version` (string)
    If this record was last touched by a bulk data operation, the sys_version at the time of that operation

  - `sys_last_modified_at` (string, required)
    The date/time that this record record was last modified, expressed in ISO-8601 date format

  - `sys_last_modified_by_id` (string, required)
    The ID of the user that last modified this record

  - `sys_last_security_context` (object)
    The security context of the last insert, modify, or delete performed on this item

  - `sys_locked` (boolean)
    If set, this record is locked and cannot be changed via the API

  - `sys_snapshot_base_version` (number)
    The version to use as a base when creating a configuration snapshot; if not set, 1 is used. Helpful when creating a sandbox

  - `sys_version` (number)
    A number representing the version of this record in the database


## Response 400 fields

## Response 401 fields

## Response 403 fields

## Response 404 fields

## Response 409 fields

## Response 429 fields

## Response 500 fields