---
title: "Create a new customer"
method: POST
path: "/api/customers"
tags: ["Customers"]
---

# Create a new customer

`POST /api/customers`

Create a customer record. The externalId should be unique and map to your application's user ID.

## Request body

- CreateCustomerDto
  - `externalId` string, required — Tenant's user ID
  - `email` string, required
  - `name` string
  - `country` string
  - `currency` string, required — 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 `201`

Customer created 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

- `409` — Customer with this externalId already exists

---

[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)