API Reference
GuidesAPI ReferenceRoadmap
API Reference
API Reference

🔒 Create customer V3

post
https://{xentralId}.xentral.biz/api/v3/customers

This endpoint is currently in Beta and available for testing. It may contain bugs, and breaking changes can occur at any time without prior notice. We do not recommend using Beta endpoints in production environments. Should you choose to use it in production, you assume full responsibility for any resulting issues.

This endpoint requires the following scopes: customer:create.

Create a new customer.

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

Customer number

string

Deviating debtor account number for accounting

mainProject
object

Main project the customer belongs to

primaryAddress
object
required

Primary address information for the customer

deviatingBillingAddress
object

Deviating billing address information

communication
object

Communication preferences and settings

financials
object

Financial information and settings

fulfillment
object

Fulfillment and delivery settings

documentDelivery
object

Document delivery preferences

accountManager
object

Account manager reference

salesManager
object

Sales manager with commission

originSalesChannel
object

Origin sales channel reference

groups
array of objects

Groups the customer belongs to

groups
customerRoles
array of objects

Customer roles associated with projects. Only roles that are currently active (based on validFrom and expiresAt dates) will be inserted.

customerRoles
customFields
array of objects

Custom fields for additional custom data

customFields
string

Notes for the customer

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

401

Unauthorized

403

Forbidden

Updated about 1 month ago

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

Updated about 1 month ago