---
title: "Create customer"
method: POST
path: "/customer/create"
tags: ["Customer"]
---

# Create customer

`POST /customer/create`

## Request

- Base URL: `https://demo.onlinebillingform.com/api/v2`
- URL: `https://demo.onlinebillingform.com/api/v2/customer/create`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/billingserv/apis/billingserv-api-v2/docs/customer/create/post.ts> (a function with typed inputs; its response is checked against the schema)

Use this BillingServ API endpoint to create customer. Set email_verified to true when the integrating platform has already verified the address; this marks the customer verified and suppresses BillingServ's verification email. Review the response for the operation result or validation errors.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `name` string, required
  - `address_1` string, required
  - `address_2` string
  - `city` string, required
  - `county_id` integer, required
  - `country_id` integer, required
  - `postal_code` string, required
  - `phone` string, required
  - `fax` string
  - `username` string, email, required
  - `password` string, password, required
  - `email_verified` boolean: When true, marks the customer email as verified and suppresses the verification email. Use this when the integrating platform has already verified the address.
  - `website` string, uri
  - `credit` number
  - `business_name` string
  - `comment` string

## Response `201`

Created

- ApiResponse
  - `success` boolean

## Other responses

- `401`: Missing or invalid API key
- `403`: Authenticated key does not have permission for this endpoint
- `404`: The selected country or county could not be found
- `409`: Idempotency key conflict or request already in progress
- `422`: Validation error
- `500`: Customer creation failed

## Changes

- **2026-08-22** `76cfbed5eb40`: 2 info
  - added the new optional request property `email_verified` (media type: application/json)
  - added the new optional request property `email_verified` (media type: application/x-www-form-urlencoded)
- **2026-08-22** `6b9208b64456`: 1 breaking, 11 info
  - removed the success response with the status `200`
  - added the new optional `header` request parameter `Idempotency-Key`
  - added the non-success response with the status `404`
  - added the non-success response with the status `409`
  - …8 more

[Operation history](https://skmtc.dev/billingserv/apis/billingserv-api-v2/changes/customer/create/post.md)

---

[API](https://skmtc.dev/billingserv/apis/billingserv-api-v2.md) - [All operations](https://skmtc.dev/billingserv/apis/billingserv-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/billingserv/apis/billingserv-api-v2/revisions/232ab5ca8413?raw)