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

# Update customer billing profile

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

## Request

- Base URL: `http://localhost:8888/api/v3`
- URL: `http://localhost:8888/api/v3/openmeter/customers/{customerId}/billing/profile`
- Auth: none declared

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` BillingProfileReference: Billing profile reference.
    - `id` string, required: ULID (Universally Unique Lexicographically Sortable Identifier).

## Response `200`

CustomerBillingProfile upsert response.

- BillingCustomerProfile: Customer billing profile selection.
  - `billing_profile` BillingProfileReference: Billing profile reference.
    - `id` string, required: ULID (Universally Unique Lexicographically Sortable Identifier).
  - `effective_billing_profile` BillingProfileReference, required: Billing profile reference.
    - `id` string, required: ULID (Universally Unique Lexicographically Sortable Identifier).

## Other responses

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

## Changes

- **2026-10-26** (v3) `4f3049608e93`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/openmeterio/apis/openmeter-api/changes/openmeter/customers/:customerId/billing/profile/put.md)

---

[API](https://skmtc.dev/openmeterio/apis/openmeter-api.md) - [All operations](https://skmtc.dev/openmeterio/apis/openmeter-api/llms.txt) - [OpenAPI document](https://skmtc.dev/openmeterio/apis/openmeter-api/revisions/c5e5c08ac656?raw)