Customers

Create customer

Changed on

Create a new customer record with address information.

Set is_taxable to false to create a tax-exempt customer (for example resellers, government agencies, or qualifying non-profits). Omit the field to use the default (false).

post/public/v1/customers/

Request

  • Base URL: https://api.dualentry.com
  • URL: https://api.dualentry.com/public/v1/customers/
  • Auth: none declared

Headers

Idempotency-Keystring

Optional. A unique value (a UUID works well) identifying this operation. If the request is repeated with the same key, the original response is replayed instead of the operation running again, so a retry cannot create a duplicate record. Results are replayable for 48 hours. Reusing a key with a different request body returns 422.

Request body

custom_fieldsobject[] nullable
namestring required
unique_idstring nullable
emailstring required
addressstring required
countrystring required
phonestring required
websitestring required
is_taxableboolean

Whether tax is calculated for this customer. Set to false to mark the customer as tax-exempt.

allowed_company_idsinteger[] nullable

Company IDs allowed to use this customer. Empty list means global (all companies).

classification_line_idsinteger[] nullable

Classification lines stored on this record.

Response

Created

classification_line_idsinteger[]
created_atstring date-time required

Date and time the record was created

updated_atstring date-time required

Date and time the record was last updated

approval_statusstring nullable
idinteger required
codestring nullable
addressstring required
countrystring required
namestring required
unique_idstring nullable required
websitestring required
emailstring required
customer_typestring required
is_activeboolean required
phonestring required
record_statusstring required
is_taxableboolean required
default_tax_codestring required
tax_registration_numberstring required
allowed_company_idsinteger[]

Changes

  • a74a611f93bbRevision changes
    • info

      added the optional property ///// to the response with the status

  • 6a577e8a2e32Revision changes
    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status