---
search:
  tags:
    - Tax Groups
    - POST
seo:
  description: >-
    ID-keyed upsert. Reference for the POST /api/v1/tax-groups endpoint in the
    Bloomcount Public API API.
sidebar:
  label: Create or update a tax group
  badge: POST
title: Create or update a tax group
type: openapi-operation
---
ID-keyed upsert.

- **Create**: omit `id`. `name` and at least one tax line are required.
- **Update**: pass `id`. Any subset of fields is patched; omit a field to leave it untouched.

A group is referenced by price lists, and changing its rate re-prices every quote that uses it, so an
integration syncing tax rules should update the existing group rather than create a second one.

**Errors**

- `422 tax_group_name_required` — creating without a name.
- `422 tax_group_lines_required` — creating with an empty `taxLines`.
- `404 tax_group_not_found` — the `id` belongs to another tenant, or doesn't exist.

<Operation source="reference" id="post-api-v1-tax-groups" />