Create customer

Creates a new customer object in Zenskar. Customer objects represent the individuals or companies you do business with and serve for your revenue operations—they must exist before you can create contracts, generate invoices, or process payments.

The customer record stores essential billing information including contact details, billing and shipping addresses, tax identifiers, payment preferences, and custom metadata specific to your business needs. Only customer_name is required at creation—all other fields are optional, allowing you to capture minimal information initially. The customer address is an important field which is used for Regional tax calculation, make sure this field is correct for the required customers.

When integrated with external systems, newly created customers are automatically synchronized with configured platforms like Stripe, HubSpot, Zoho, or Xero. Use the external_id field to maintain references to source systems for bidirectional synchronization.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
length ≤ 255

External identifier for this customer from your system or third-party CRM (e.g., Salesforce ID)

string
required
Defaults to Acme Corporation

Full name of the customer or company

custom_data

Custom key-value pairs for storing additional customer information (e.g., industry, account tier, sales rep)

address

Primary billing address for the customer

ship_to_address

Shipping address if different from billing address

tax_info

List of tax identifiers for the customer (e.g., VAT number, GST number)

Primary email address for the customer (must be unique within organization)

Primary phone number for the customer (include country code, e.g., +1-555-0100)

connector

External connector information for integration with third-party systems

Enable or disable email communications for this customer (invoices, receipts, etc.)

Enable or disable automatic payment charging for invoices

Business entity ID to associate with this customer

Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json