POST
/
v2
/
clients
curl --request POST \
  --url https://thirdparty.qonto.com/v2/clients \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>",
  "first_name": "<string>",
  "last_name": "<string>",
  "type": "individual",
  "email": "john.doe@qonto.eu",
  "extra_emails": [
    "additional@email.com",
    "backup@email.com"
  ],
  "vat_number": "<string>",
  "tax_identification_number": "<string>",
  "address": "<string>",
  "city": "<string>",
  "zip_code": "<string>",
  "province_code": "<string>",
  "country_code": "FR",
  "billing_address": {
    "street_address": "123 Main Street",
    "city": "Paris",
    "zip_code": "75009",
    "province_code": "<string>",
    "country_code": "FR"
  },
  "delivery_address": {
    "street_address": "123 Main Street",
    "city": "Paris",
    "zip_code": "75009",
    "province_code": "<string>",
    "country_code": "FR"
  },
  "recipient_code": "<string>",
  "currency": "EUR",
  "locale": "FR"
}'
{
  "client": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "type": "company",
    "email": "john.doe@qonto.eu",
    "extra_emails": [
      "additional@email.com",
      "backup@email.com"
    ],
    "vat_number": "<string>",
    "tax_identification_number": "<string>",
    "address": "<string>",
    "city": "<string>",
    "zip_code": "<string>",
    "province_code": "<string>",
    "country_code": "<string>",
    "billing_address": {
      "street_address": "123 Main Street",
      "city": "Paris",
      "zip_code": "75009",
      "province_code": "<string>",
      "country_code": "fr"
    },
    "delivery_address": {
      "street_address": "123 Main Street",
      "city": "Paris",
      "zip_code": "75009",
      "province_code": "<string>",
      "country_code": "fr"
    },
    "recipient_code": "<string>",
    "created_at": "<string>",
    "locale": "fr"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authorization header: Bearer <token>, where <token> is the access token received from the authorization server at the end of the OAuth 2.0 flow.

Headers

​
X-Qonto-Staging-Token
string

Required only for Sandbox API requests; to get one, please sign up to the Developer Portal.

Body

application/json

When creating a client to be used for invoicing purposes, do note:

  • A client can be created by only specifying a type and a name (depending on the chosen type);

  • however, to be able to use that client for invoicing, the following additional fields must also be provided:

    • currency
    • locale
    • address, either as root-level fields (address, city, zip_code, province_code and country_code) or inside the billing_address field object.

The body is of type object.

Response

200
application/json

Returns the client created.

The response is of type object.

POST
/
v2
/
clients
curl --request POST \
  --url https://thirdparty.qonto.com/v2/clients \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>",
  "first_name": "<string>",
  "last_name": "<string>",
  "type": "individual",
  "email": "john.doe@qonto.eu",
  "extra_emails": [
    "additional@email.com",
    "backup@email.com"
  ],
  "vat_number": "<string>",
  "tax_identification_number": "<string>",
  "address": "<string>",
  "city": "<string>",
  "zip_code": "<string>",
  "province_code": "<string>",
  "country_code": "FR",
  "billing_address": {
    "street_address": "123 Main Street",
    "city": "Paris",
    "zip_code": "75009",
    "province_code": "<string>",
    "country_code": "FR"
  },
  "delivery_address": {
    "street_address": "123 Main Street",
    "city": "Paris",
    "zip_code": "75009",
    "province_code": "<string>",
    "country_code": "FR"
  },
  "recipient_code": "<string>",
  "currency": "EUR",
  "locale": "FR"
}'
{
  "client": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "type": "company",
    "email": "john.doe@qonto.eu",
    "extra_emails": [
      "additional@email.com",
      "backup@email.com"
    ],
    "vat_number": "<string>",
    "tax_identification_number": "<string>",
    "address": "<string>",
    "city": "<string>",
    "zip_code": "<string>",
    "province_code": "<string>",
    "country_code": "<string>",
    "billing_address": {
      "street_address": "123 Main Street",
      "city": "Paris",
      "zip_code": "75009",
      "province_code": "<string>",
      "country_code": "fr"
    },
    "delivery_address": {
      "street_address": "123 Main Street",
      "city": "Paris",
      "zip_code": "75009",
      "province_code": "<string>",
      "country_code": "fr"
    },
    "recipient_code": "<string>",
    "created_at": "<string>",
    "locale": "fr"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authorization header: Bearer <token>, where <token> is the access token received from the authorization server at the end of the OAuth 2.0 flow.

Headers

​
X-Qonto-Staging-Token
string

Required only for Sandbox API requests; to get one, please sign up to the Developer Portal.

Body

application/json

When creating a client to be used for invoicing purposes, do note:

  • A client can be created by only specifying a type and a name (depending on the chosen type);

  • however, to be able to use that client for invoicing, the following additional fields must also be provided:

    • currency
    • locale
    • address, either as root-level fields (address, city, zip_code, province_code and country_code) or inside the billing_address field object.

The body is of type object.

Response

200
application/json

Returns the client created.

The response is of type object.