BRbrex-com
Accounting VAT

Update tax group

Changed on

Apply per-subsidiary status changes (partial-apply; unlisted subsidiaries unchanged). Name and membership are immutable.

patch/v3/accounting/integration/{integration_id}/tax-groups/{brex_id}

Request

Path parameters

brex_idstring required
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

Example request

{
  "subsidiaries": [
    {
      "status": "ENABLED",
      "subsidiary_id": "sub_uk_ltd"
    }
  ]
}

Response

Tax group updated

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