Skip to main content
POST
/
v2
/
products
Create a product
curl --request POST \
  --url https://thirdparty.qonto.com/v2/products \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Web Development Service",
  "type": "service",
  "unit_price": {
    "value": "150.00",
    "currency": "EUR"
  },
  "vat_rate": "0.2",
  "description": "Full-stack web development service",
  "internal_note": "Preferred vendor for web projects",
  "unit": "hour",
  "vat_exemption_code": "N1",
  "links": [
    {
      "title": "Product page",
      "url": "https://www.example.com/product"
    }
  ]
}
'
{
  "product": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "title": "Web Development Service",
    "type": "service",
    "unit_price": {
      "value": "150.00",
      "currency": "EUR"
    },
    "vat_rate": "0.2",
    "organization_id": "f1e2d3c4-b5a6-7890-abcd-ef1234567890",
    "created_at": "2026-01-15T10:30:00Z",
    "updated_at": "2026-01-15T10:30:00Z",
    "description": "Full-stack web development service",
    "internal_note": "Preferred vendor for web projects",
    "unit": "hour",
    "vat_exemption_code": "N1",
    "links": [
      {
        "title": "Product page",
        "url": "https://www.example.com/product"
      }
    ]
  }
}

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

Payload for creating a product.

​
title
string
required

Title of the product.

Maximum string length: 120
Example:

"Web Development Service"

​
type
enum<string>
required

Whether the product is a good or a service.

Available options:
good,
service
Example:

"service"

​
unit_price
object
required

The unit price of the product.

​
vat_rate
string
required

The VAT rate as a decimal (e.g. "0.2" for 20%).

Example:

"0.2"

​
description
string

Description of the product.

Maximum string length: 600
Example:

"Full-stack web development service"

​
internal_note
string

Internal note for the product (not visible to clients).

Maximum string length: 50000
Example:

"Preferred vendor for web projects"

​
unit
string

The unit of measurement for the product (e.g. "kilogram", "hour").

Example:

"hour"

​
vat_exemption_code
enum<string>

VAT exemption code, applicable when vat_rate is "0". Required for Italian organizations when the VAT rate is 0.

Available options:
N1,
N2,
N2.1,
N2.2,
N3,
N3.1,
N3.2,
N3.3,
N3.4,
N3.5,
N3.6,
N4,
N5,
N6,
N6.1,
N6.2,
N6.3,
N6.4,
N6.5,
N6.6,
N6.7,
N6.8,
N6.9,
N7,
S293B,
S262.1,
S259,
S283,
S261,
S262,
S263,
S19.1,
S4.1B,
S4.1A,
S4,
S13B,
S122,
S25,
S21,
S69,
S20,
S84.1.2
Example:

"N1"

​
links
object[]

External links associated with the product.

Response

Returns the product created.

​
product
object
required

A product belonging to the organization.