Skip to main content
POST
Create a 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"

External links associated with the product.

Response

Returns the product created.

product
object
required

A product belonging to the organization.