---
title: "Update a customer"
method: PATCH
path: "/api/customers/{id}"
tags: ["Customers"]
---

# Update a customer

`PATCH /api/customers/{id}`

Update customer fields. Only provided fields will be changed.

## Path parameters

- `id` string, required

## Request body

- UpdateCustomerDto
  - `externalId` string — Tenant's user ID
  - `email` string
  - `name` string
  - `country` string
  - `currency` string — ISO currency code
  - `metadata` object — Custom metadata
  - `netPaymentTerms` number — Net payment terms in days (overrides org and plan defaults)
  - `createdAt` string — Backdate createdAt (ISO 8601). For data imports.

## Response `200`

Customer updated successfully

- CustomerResponse
  - `id` string, required
  - `externalId` string, required
  - `email` string, required
  - `name` string
  - `country` string
  - `currency` string, required
  - `metadata` object
  - `createdAt` string, required
  - `updatedAt` string, required

## Other responses

- `404` — Customer not found

---

[API](https://skmtc.net/novabilling/apis/novabilling-api.md) · [All operations](https://skmtc.net/novabilling/apis/novabilling-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/novabilling/novabilling-api/versions/0e449a4e0dc8/schema)