---
title: "Update customer billing profile"
method: PUT
path: "/v3/openmeter/customers/{customerId}/billing/profile"
tags: ["OpenMeter Customers"]
---

# Update customer billing profile

`PUT /v3/openmeter/customers/{customerId}/billing/profile`

## Request

- Base URL: `https://global.api.konghq.com`
- URL: `https://global.api.konghq.com/v3/openmeter/customers/{customerId}/billing/profile`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer
- TypeScript: <https://skmtc.dev/kong/apis/konnect-api-go-sdk/docs/v3/openmeter/customers/:customerId/billing/profile/put.ts> (a function with typed inputs; its response is checked against the schema)

Set the customer's explicit billing profile selection. Omitting billing_profile
or setting it to null removes the selection and uses the current namespace
default.

## Path parameters

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

## Request body

- UpsertCustomerBillingProfileRequest: CustomerBillingProfile upsert request.
  - `billing_profile` object, nullable: The billing profile explicitly selected for the customer. Unpinned customers use the current namespace default. Selecting the current default explicitly pins the customer to that profile.
    - `id` string, required: The ID of the billing profile.

## Response `200`

CustomerBillingProfile upsert response.

- BillingCustomerProfile: Customer billing profile selection.
  - `billing_profile` object, nullable: The billing profile explicitly selected for the customer. Unpinned customers use the current namespace default. Selecting the current default explicitly pins the customer to that profile.
    - `id` string, required: The ID of the billing profile.
  - `effective_billing_profile` object, required: The effective billing profile for the customer. Uses the explicitly selected billing profile when pinned, otherwise the current default billing profile.
    - `id` string, required: The ID of the billing profile.

## Other responses

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

## Changes

- **2026-10-29** `e8dc0bf07bd9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/kong/apis/konnect-api-go-sdk/changes/v3/openmeter/customers/:customerId/billing/profile/put.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/ff8439091e5f?raw)