Customer

Create customer

Changed on Aug 22, 2026

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.

post/customer/create

Request

Base URL
https://demo.onlinebillingform.com/api/v2
Auth
HTTP bearer
TypeScript
https://skmtc.dev/b-cdn/apis/billingserv-api-v2/docs/customer/create/post.ts
A function with typed inputs. Its response is checked against the schema.

Headers

Idempotency-Keystring

Optional key for POST /customer/create, POST /invoice/create-quote, POST /invoice/create-invoice, POST /invoice/update-invoice, and POST /order/add-order. Reusing the same key with the same request replays a successful response for 24 hours; reusing it with a different request returns 409.

Request body

namestring required

address_1string required

address_2string

citystring required

county_idinteger required

country_idinteger required

postal_codestring required

phonestring required

faxstring

usernamestring email required

passwordstring password required

email_verifiedboolean

When true, marks the customer email as verified and suppresses the verification email. Use this when the integrating platform has already verified the address.

websitestring uri

creditnumber

business_namestring

commentstring

Response

Created

successboolean

Changes

Aug 22, 202676cfbed5eb40 Revision changes
- info
  added the new optional request property (media type: application/json)
- info
  added the new optional request property (media type: application/x-www-form-urlencoded)
Aug 22, 20266b9208b64456 Revision changes
- breaking
  removed the success response with the status
- info
  added the new optional header request parameter Idempotency-Key
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the success response with the status

Operation history