---
title: "Update organization default tax codes"
method: PUT
path: "/openmeter/defaults/tax-codes"
tags: ["OpenMeter Defaults"]
---

# Update organization default tax codes

`PUT /openmeter/defaults/tax-codes`

## Request body

- UpdateOrganizationDefaultTaxCodesRequest — OrganizationDefaultTaxCodes update request.
  - `invoicing_tax_code` TaxCodeReference — TaxCode reference.
    - `id` string, required — ULID (Universally Unique Lexicographically Sortable Identifier).
  - `credit_grant_tax_code` TaxCodeReference — TaxCode reference.
    - `id` string, required — ULID (Universally Unique Lexicographically Sortable Identifier).

## Response `200`

OrganizationDefaultTaxCodes upsert response.

- OrganizationDefaultTaxCodes — Organization-level default tax code references. Stores the default tax codes applied to specific billing contexts for this organization. Provisioned automatically when the organization is created.
  - `invoicing_tax_code` TaxCodeReference, required — TaxCode reference.
    - `id` string, required — ULID (Universally Unique Lexicographically Sortable Identifier).
  - `credit_grant_tax_code` TaxCodeReference, required — TaxCode reference.
    - `id` string, required — ULID (Universally Unique Lexicographically Sortable Identifier).
  - `created_at` string, date-time, required — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC.
  - `updated_at` string, date-time, required — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/openmeterio/apis/openmeter-and-konnect-metering-billing-api.md) · [All operations](https://skmtc.net/openmeterio/apis/openmeter-and-konnect-metering-billing-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openmeterio/openmeter-and-konnect-metering-billing-api/versions/9bca44e2d61d/schema)