POST
/
consumers
/
{consumer_id}
/
accounting
/
clients
Create client
curl --request POST \
  --url https://api.chift.eu/consumers/{consumer_id}/accounting/clients \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "external_reference": "<string>",
  "first_name": "<string>",
  "last_name": "<string>",
  "name": "<string>",
  "function": "<string>",
  "is_company": true,
  "company_id": "<string>",
  "phone": "<string>",
  "mobile": "<string>",
  "email": "<string>",
  "language": "<string>",
  "internal_notes": "<string>",
  "website": "<string>",
  "vat": "<string>",
  "iban": "<string>",
  "bank_account": "<string>",
  "currency": "<string>",
  "active": true,
  "addresses": [
    {
      "address_type": "main",
      "name": "<string>",
      "number": "<string>",
      "box": "<string>",
      "phone": "<string>",
      "mobile": "<string>",
      "email": "<string>",
      "street": "<string>",
      "city": "<string>",
      "postal_code": "<string>",
      "country": "<string>"
    }
  ],
  "account_number": "<string>"
}'
{
  "external_reference": "<string>",
  "first_name": "<string>",
  "last_name": "<string>",
  "name": "<string>",
  "function": "<string>",
  "is_company": true,
  "company_id": "<string>",
  "phone": "<string>",
  "mobile": "<string>",
  "email": "<string>",
  "language": "<string>",
  "internal_notes": "<string>",
  "website": "<string>",
  "vat": "<string>",
  "iban": "<string>",
  "bank_account": "<string>",
  "currency": "<string>",
  "active": true,
  "account_number": "<string>",
  "company_number": "<string>",
  "id": "<string>",
  "last_updated_on": "2023-11-07T05:31:56Z",
  "addresses": [
    {
      "address_type": "main",
      "name": "<string>",
      "number": "<string>",
      "box": "<string>",
      "phone": "<string>",
      "mobile": "<string>",
      "email": "<string>",
      "street": "<string>",
      "city": "<string>",
      "postal_code": "<string>",
      "country": "<string>"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

This access token needs to be included in each of your request to the Chift API.

Path Parameters

​
consumer_id
string<uuid>
required

Query Parameters

​
folder_id
string | null

Id of the accounting folder instance. A folder represents a legal entity within the system. Required when the multiple folders feature is enabled.

​
force_merge
string | null

Indicate the ID of the corresponding supplier in the accounting system. Accounting systems using 1 entity to handle clients/customers and suppliers will merge the existing supplier with the new client/customer (if the parameter is filled in with the ID of an existing supplier).

Body

application/json

Response

Successful Response

The response is of type object.