Skip to main content
POST
/
clients
/
Create a client
curl --request POST \
  --url https://gate.chip-in.asia/api/v1/clients/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "bank_account": "<string>",
  "bank_code": "<string>",
  "email": "jsmith@example.com",
  "phone": "+44 45643564564",
  "full_name": "<string>",
  "personal_code": "<string>",
  "street_address": "<string>",
  "country": "<string>",
  "city": "<string>",
  "zip_code": "<string>",
  "state": "<string>",
  "shipping_street_address": "<string>",
  "shipping_country": "<string>",
  "shipping_city": "<string>",
  "shipping_zip_code": "<string>",
  "shipping_state": "<string>",
  "cc": [
    "jsmith@example.com"
  ],
  "bcc": [
    "jsmith@example.com"
  ],
  "legal_name": "<string>",
  "brand_name": "<string>",
  "registration_number": "<string>",
  "tax_number": "<string>"
}'
{
  "type": "<string>",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_on": 1619740800,
  "updated_on": 1619740800,
  "bank_account": "<string>",
  "bank_code": "<string>",
  "email": "jsmith@example.com",
  "phone": "+44 45643564564",
  "full_name": "<string>",
  "personal_code": "<string>",
  "street_address": "<string>",
  "country": "<string>",
  "city": "<string>",
  "zip_code": "<string>",
  "state": "<string>",
  "shipping_street_address": "<string>",
  "shipping_country": "<string>",
  "shipping_city": "<string>",
  "shipping_zip_code": "<string>",
  "shipping_state": "<string>",
  "cc": [
    "jsmith@example.com"
  ],
  "bcc": [
    "jsmith@example.com"
  ],
  "legal_name": "<string>",
  "brand_name": "<string>",
  "registration_number": "<string>",
  "tax_number": "<string>"
}
Client is a record of a single customer of your business. Create one for each of your clients; you will be able to issue invoices/subscriptions for them later easily using /billing_templates/ API. Each BillingTemplateClient (there can be many attached to a single BillingTemplate) will bind a single Client to a BillingTemplate.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Record of a single customer of your business. Create one for each of your clients; you will be able to issue invoices/subscriptions for them later easily using /billing_templates/ API.

Each BillingTemplateClient (there can be many attached to a single BillingTemplate) will bind a single Client to a BillingTemplate. Contains details about the client of a purchase or payment - the remote payer/fund recipient party.

​
email
string<email>
required

Email address

Maximum length: 254
​
phone
string<phone>

Phone number in the <country_code> <number> format

Maximum length: 32
Example:

"+44 45643564564"

​
full_name
string

Name and surname of client. It is advisable to include full_name in request body.

Maximum length: 128
​
personal_code
string

Personal identification code of client

Maximum length: 32
​
street_address
string

Street house number and flat address where applicable

Maximum length: 128
​
country
string<ISO 3166-1 alpha-2>

Country code in the ISO 3166-1 alpha-2 format (e.g. 'GB')

Maximum length: 2
​
city
string

City name

Maximum length: 128
​
zip_code
string

ZIP or postal code

Maximum length: 32
​
state
string

State code

Maximum length: 128
​
shipping_street_address
string

Street house number and flat address where applicable

Maximum length: 128
​
shipping_country
string<ISO 3166-1 alpha-2>

Country code in the ISO 3166-1 alpha-2 format (e.g. 'GB')

Maximum length: 2
​
shipping_city
string

City name

Maximum length: 128
​
shipping_zip_code
string

ZIP or postal code

Maximum length: 32
​
shipping_state
string

State code

Maximum length: 128
​
cc
string<email>[]

Email addresses to receive a carbon copy of all notification emails

Email address

​
bcc
string<email>[]

Email addresses to receive a blind carbon copy of all notification emails

Email address

​
legal_name
string

Legal name of company

Maximum length: 128
​
brand_name
string

Company brand name

Maximum length: 128
​
registration_number
string

Registration number of company

Maximum length: 32
​
tax_number
string

Tax payer registration number

Maximum length: 32
​
bank_account
string

Bank account number (e.g. IBAN)

Maximum length: 34
​
bank_code
string

SWIFT/BIC code of the bank

Maximum length: 11

Response

OK

Record of a single customer of your business. Create one for each of your clients; you will be able to issue invoices/subscriptions for them later easily using /billing_templates/ API.

Each BillingTemplateClient (there can be many attached to a single BillingTemplate) will bind a single Client to a BillingTemplate. Contains details about the client of a purchase or payment - the remote payer/fund recipient party.

​
email
string<email>
required

Email address

Maximum length: 254
​
type
string

Object type identifier

​
id
string<uuid>
​
created_on
integer

Object creation time

Example:

1619740800

​
updated_on
integer

Object last modification time

Example:

1619740800

​
phone
string<phone>

Phone number in the <country_code> <number> format

Maximum length: 32
Example:

"+44 45643564564"

​
full_name
string

Name and surname of client. It is advisable to include full_name in request body.

Maximum length: 128
​
personal_code
string

Personal identification code of client

Maximum length: 32
​
street_address
string

Street house number and flat address where applicable

Maximum length: 128
​
country
string<ISO 3166-1 alpha-2>

Country code in the ISO 3166-1 alpha-2 format (e.g. 'GB')

Maximum length: 2
​
city
string

City name

Maximum length: 128
​
zip_code
string

ZIP or postal code

Maximum length: 32
​
state
string

State code

Maximum length: 128
​
shipping_street_address
string

Street house number and flat address where applicable

Maximum length: 128
​
shipping_country
string<ISO 3166-1 alpha-2>

Country code in the ISO 3166-1 alpha-2 format (e.g. 'GB')

Maximum length: 2
​
shipping_city
string

City name

Maximum length: 128
​
shipping_zip_code
string

ZIP or postal code

Maximum length: 32
​
shipping_state
string

State code

Maximum length: 128
​
cc
string<email>[]

Email addresses to receive a carbon copy of all notification emails

Email address

​
bcc
string<email>[]

Email addresses to receive a blind carbon copy of all notification emails

Email address

​
legal_name
string

Legal name of company

Maximum length: 128
​
brand_name
string

Company brand name

Maximum length: 128
​
registration_number
string

Registration number of company

Maximum length: 32
​
tax_number
string

Tax payer registration number

Maximum length: 32
​
bank_account
string

Bank account number (e.g. IBAN)

Maximum length: 34
​
bank_code
string

SWIFT/BIC code of the bank

Maximum length: 11
⌘I