BRbrex-com
Accounting VAT

Create tax code

Changed on

Create a tax code for a non-native integration and enable it for the requested subsidiaries. Other subsidiaries default to DISABLED. Native ERP integrations are not eligible because their VAT configuration is owned by the ERP sync.

post/v3/accounting/integration/{integration_id}/tax-codes

Request

Path parameters

integration_idstring required

Headers

Idempotency-Keystring

Caller-generated key (recommend a v4 UUID) that uniquely identifies this logical request. Reuse the same value when retrying so the request is de-duplicated.

Request body

namestring required

Name of the tax code. Reserved names ("Not Eligible", "Custom") are rejected

ratenumber required

Tax rate as a percentage (e.g. 20 for 20%). Use 0 for zero-rated. Required on create

remote_idstring

The tax code's identifier in the remote accounting system. Omit when the remote system has no identifier.

subsidiary_idsstring[] required

Subsidiaries to enable this code for on creation

Example request

{
  "name": "UK Standard",
  "rate": 20,
  "remote_id": "remote-tax-uk-vat-20",
  "subsidiary_ids": [
    "sub_uk_ltd",
    "sub_ie_ltd"
  ]
}

Response

Tax code created

brex_idstring required

The internal Brex ID of the tax code

namestring required

Human-readable name of the tax code

ratenumber nullable

Tax rate as a percentage (e.g. 20 for 20%). 0 is zero-rated; null is exempt

remote_idstring nullable

The tax code's identifier in the remote accounting system. Null when the caller did not provide one.

updated_atstring date-time required

The last updated timestamp of the tax code

Example response

{
  "brex_id": "tc_abc123",
  "name": "UK Standard",
  "rate": 20,
  "remote_id": "remote-tax-uk-vat-20",
  "subsidiaries": [
    {
      "status": "ENABLED",
      "subsidiary_id": "sub_uk_ltd",
      "subsidiary_name": "UK Ltd"
    }
  ],
  "updated_at": "2025-01-01T00:00:00Z"
}

Changes