Create a product

POST

catalogue

products

Authorizations

Authorization

string

header

required

Value for the Authorization header parameter.

Body

measurement

object

required

The measurement that is used for the price plan. This could define the quantity or a metered usage.

measurement.code

string

required

A unique code which can be used to identify the measurement.

Required string length: 1 - 255

measurement.unit

object | null

required

The unit of the measurement.

measurement.aggregationType

any

The aggregation type of the measurement. Describes how the quantity is calculated. This cannot be changed after creation, otherwise it would change the whole calculation for existing subscriptions.

Possible values:

count: The number of sent measurements in the billing interval. Metered usage, which resets to 0 after each billing interval.
count_unique: The number of unique sent measurements in the billing interval, identified by the id given on event creation.
max: The maximum value of all sent measurements in the billing interval. Metered usage, which resets to 0 after each billing interval.
sum: The sum of all sent measurements in the billing interval.
last_value: The last sent measurement.
average: The average of all sent measurements in the billing interval.

measurement.description

string | null

A description of the measurement, which is shown in the summary of the usage data in the invoice.

Maximum length: 255

measurement.fairBilling

boolean

default:

true

If set to false, the measurement will be billed for the whole billing interval, even if the quantity changes, or the item is cancelled / terminated during the billing interval.

measurement.type

any

The type of the measurement. This cannot be changed after creation, otherwise it would change the whole calculation for existing subscriptions.

Possible values:

instant_metered: The measurement value is reset to 0 after each push. The measurement gets billed immediately and an invoice is created. The aggregation type must be "last_value".
metered: The measurement value is reset to 0 after each billing interval.
recurring: The measurement value is not reset to 0 after each billing interval and the last value is used for all following billing intervals. The aggregation type must be "last_value".

productFamilies

object[]

required

A product family groups multiple products together.

taxGroup

object

required

The tax group that is used for the product.

translations

object

required

The translations of the product. The locale is used as key.

type

enum<string>

required

The type of the product.

product: recurring billed product
charge: one-time billing
plan: plan specific product, which cannot be used as a normal product. Will be filtered out in any product lists.

Available options:

product,

charge,

plan

costCentre

object | null

The cost centre is used for accounting exports.

createdAt

string

customFields

object | null

Custom fields for the entity. The keys are the field names and the values are the field values. They need to be configured under "/custom-fields" in the API documentation. The input is validated against the configuration. For more details see Custom Fields Guide

description

string | null

The description of the product based on the current tenant language.

internalName

string | null

Internal name of the product, to differentiate between products with the same name. This will shown in web-app lists, selections and reports.

invoiceVisibility

enum<string>

Defines when the product should be displayed in the invoice.

always: The product is always displayed in the invoice.
only_if_charged: The product is only displayed in the invoice if it is charged.

Available options:

always,

only_if_charged

isArchived

boolean

Defines if the product is archived and should not be used anymore.

name

string

The name of the product based on the current tenant language. This will be displayed on customer communication.

number

string | null

Internal product number

Required string length: 2 - 255

updatedAt

string

Response

201 - application/json

measurement

object

required

The measurement that is used for the price plan. This could define the quantity or a metered usage.

measurement.code

string

required

A unique code which can be used to identify the measurement.

Required string length: 1 - 255

measurement.unit

object | null

required

The unit of the measurement.

measurement.aggregationType

any

The aggregation type of the measurement. Describes how the quantity is calculated. This cannot be changed after creation, otherwise it would change the whole calculation for existing subscriptions.

Possible values:

count: The number of sent measurements in the billing interval. Metered usage, which resets to 0 after each billing interval.
count_unique: The number of unique sent measurements in the billing interval, identified by the id given on event creation.
max: The maximum value of all sent measurements in the billing interval. Metered usage, which resets to 0 after each billing interval.
sum: The sum of all sent measurements in the billing interval.
last_value: The last sent measurement.
average: The average of all sent measurements in the billing interval.

measurement.description

string | null

A description of the measurement, which is shown in the summary of the usage data in the invoice.

Maximum length: 255

measurement.fairBilling

boolean

default:

true

If set to false, the measurement will be billed for the whole billing interval, even if the quantity changes, or the item is cancelled / terminated during the billing interval.

measurement.id

string

A unique identifier for the measurement.

measurement.type

any

The type of the measurement. This cannot be changed after creation, otherwise it would change the whole calculation for existing subscriptions.

Possible values:

instant_metered: The measurement value is reset to 0 after each push. The measurement gets billed immediately and an invoice is created. The aggregation type must be "last_value".
metered: The measurement value is reset to 0 after each billing interval.
recurring: The measurement value is not reset to 0 after each billing interval and the last value is used for all following billing intervals. The aggregation type must be "last_value".

productFamilies

object[]

required

A product family groups multiple products together.

taxGroup

object

required

The tax group that is used for the product.

translations

object

required

The translations of the product. The locale is used as key.

type

enum<string>

required

The type of the product.

product: recurring billed product
charge: one-time billing
plan: plan specific product, which cannot be used as a normal product. Will be filtered out in any product lists.

Available options:

product,

charge,

plan

costCentre

object | null

The cost centre is used for accounting exports.

createdAt

string

customFields

object | null

description

string | null

The description of the product based on the current tenant language.

string

The unique identifier of the product.

internalName

string | null

Internal name of the product, to differentiate between products with the same name. This will shown in web-app lists, selections and reports.

invoiceVisibility

enum<string>

Defines when the product should be displayed in the invoice.

always: The product is always displayed in the invoice.
only_if_charged: The product is only displayed in the invoice if it is charged.

Available options:

always,

only_if_charged

isArchived

boolean

Defines if the product is archived and should not be used anymore.

name

string

The name of the product based on the current tenant language. This will be displayed on customer communication.

number

string | null

Internal product number

Required string length: 2 - 255

updatedAt

string

Was this page helpful?

Get products Get a product

API documentation

User

Tenant

Feature

Entitlement

User & permissions

Settings

Payment

Analytics

Customer

Billing

Dunning

Subscription

Offers

Catalogue

Checkout

Accounting

Taxes

Authorizations

Body

Response