---
title: "Create a credit adjustment"
method: POST
path: "/v3/openmeter/customers/{customerId}/credits/adjustments"
tags: ["OpenMeter Customers"]
---

# Create a credit adjustment

`POST /v3/openmeter/customers/{customerId}/credits/adjustments`

## Request

- Base URL: `https://global.api.konghq.com`
- URL: `https://global.api.konghq.com/v3/openmeter/customers/{customerId}/credits/adjustments`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer

**Pre-release Endpoint**
This endpoint is currently in beta and is subject to change.

A credit adjustment can be used to make manual adjustments to a customer's
credit balance.

Supported use-cases:

- Usage correction

## Path parameters

- `customerId` string, required: ULID (Universally Unique Lexicographically Sortable Identifier).

## Request body

- CreateCreditAdjustmentRequest: CreditAdjustment create request.
  - `name` string, required: Display name of the resource. Between 1 and 256 characters.
  - `description` string: Optional description of the resource. Maximum 1024 characters.
  - `labels` Labels: Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
  - `currency` union, required: The currency of the granted credits.
    - string: Three-letter [ISO4217](https://www.iso.org/iso-4217-currency-codes.html) currency code. Custom three-letter currency codes are also supported for convenience.
    - string: Custom currency code. It should be a unique code but not conflicting with any existing fiat currency codes.
  - `amount` string, required: Granted credit amount.

## Response `201`

CreditAdjustment created response.

- BillingCreditAdjustment: A credit adjustment can be used to make manual adjustments to a customer's credit balance. Supported use-cases: - Usage correction
  - `name` string, required: Display name of the resource. Between 1 and 256 characters.
  - `description` string: Optional description of the resource. Maximum 1024 characters.
  - `labels` Labels: Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".

## Other responses

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

## Changes

- **2026-10-15** `7aab863a6daa`: 1 breaking, 2 warning
  - added `#/components/schemas/InvalidParameterMinimumTime, #/components/schemas/InvalidParameterMaximumTime` to the `invalid_parameters/items/` response property `oneOf` list for the response status `400`
  - added the new `key_invalid` enum value to the `invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
  - added the new `unique` enum value to the `invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
- **2026-09-25** `68d43091b84d`: 3 warning
  - added the new `400.00` enum value to the `status` response property for the response status `400`
  - added the new `403.00` enum value to the `status` response property for the response status `403`
  - added the new `404.00` enum value to the `status` response property for the response status `404`
- **2026-09-18** `f324fb7610e4`: 4 breaking, 27 info
  - the `currency` request property type changed from `string` to no type
  - the response's body type changed from no type to `object` for status `400`
  - the response's body type changed from no type to `object` for status `403`
  - the response's body type changed from no type to `object` for status `404`
  - …27 more
- **2026-07-16** `a2e95e9f6c80`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/kong/apis/konnect-api-go-sdk/changes/v3/openmeter/customers/:customerId/credits/adjustments/post.md)

---

[API](https://skmtc.dev/kong/apis/konnect-api-go-sdk.md) · [All operations](https://skmtc.dev/kong/apis/konnect-api-go-sdk/llms.txt) · [OpenAPI document](https://skmtc.dev/kong/apis/konnect-api-go-sdk/revisions/7aab863a6daa?raw)