BRbrex-com
Accounting VAT

Create tax group

Changed on

Create a tax group for a non-native integration from existing tax codes 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-groups

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 group. Reserved names ("Not Eligible", "Custom") are rejected

subsidiary_idsstring[] required

Subsidiaries to enable this group for on creation

tax_code_idsstring[] required

The Brex IDs of the existing tax codes to include in this group

Example request

{
  "name": "QC Combined",
  "subsidiary_ids": [
    "sub_ca_inc"
  ],
  "tax_code_ids": [
    "tc_gst",
    "tc_qst"
  ]
}

Response

Tax group created

brex_idstring required

The internal Brex ID of the tax group

namestring required

Human-readable name of the tax group

updated_atstring date-time required

The last updated timestamp of the tax group

Example response

{
  "brex_id": "tc_grp1",
  "name": "QC Combined",
  "subsidiaries": [
    {
      "status": "ENABLED",
      "subsidiary_id": "sub_uk_ltd",
      "subsidiary_name": "UK Ltd"
    }
  ],
  "tax_codes": [
    {
      "brex_id": "tc_gst",
      "name": "GST",
      "rate": 5,
      "updated_at": "2025-01-01T00:00:00Z"
    }
  ],
  "updated_at": "2025-01-01T00:00:00Z"
}

Changes