Sign in
Customer

Create customer

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

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

Changed in 2 of the 6 revisions of this API.113

  • 76cfbed5eb402See the full diff
    • ○

      added the new optional request property email_verified (media type: application/json)

      new-optional-request-property

    • ○

      added the new optional request property email_verified (media type: application/x-www-form-urlencoded)

      new-optional-request-property

  • 6b9208b64456111See the full diff
    • ▲

      removed the success response with the status 200

      response-success-status-removed

    • ○

      added the new optional header request parameter Idempotency-Key

      new-optional-request-parameter

    • ○

      added the non-success response with the status 404

      response-non-success-status-added

    • ○

      added the non-success response with the status 409

      response-non-success-status-added

    • ○

      added the non-success response with the status 500

      response-non-success-status-added

    • ○

      added the optional property code to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property code to the response with the 403 status

      response-optional-property-added

    • ○

      added the optional property code to the response with the 422 status

      response-optional-property-added

    • ○

      added the optional property request_id to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property request_id to the response with the 403 status

      response-optional-property-added

    • ○

      added the optional property request_id to the response with the 422 status

      response-optional-property-added

    • ○

      added the success response with the status 201

      response-success-status-added