Create a new customer

post

https://api.spirii.com/v2/customers

Creates a new customer record in the system.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

The customer to be created.

name

string

required

length ≤ 80

The complete name of the customer.

externalId

string

length ≤ 40

The string identifier of the customer from the external system.

country

string

required

length between 2 and 2

The country of the billing address.

contactDetails

object

required

The contact details of the person who can be contacted regarding any concerns about this customer.

payoutInformation

object

The payout information of the customer. It's important to pass this information if you use Spirii financial services. This ensures correct invoicing.

billingDetails

object

The billing details of the customer. It's important to pass this information if you use Spirii financial services.

financialSetup

object

This financial setup ensures the customer receives accurate invoices in the correct language and currency, and on time.

billingSettings

object

The billing settings of the customer.

ownerId

integer

required

The unique identifier of the owner also known as the parent customer.

type

string

enum

required

The type of customer. You can create private, business or CPOSubsidiary customers.

Allowed:

Responses

400

Bad Request. An explanation message will be provided.

401

Unauthorized. The requested operation cannot be performed with the current access permissions.

403

Forbidden. Your credentials are missing or not valid. An explanation message will be provided.

500

An unexpected error occurred on the server while processing the request.

502

The request failed due to an error in an upstream service.

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201