Skip to main content

Create a new bulk price

POST 

/v2/bulk-prices

Create a new bulk price

Request

Body

required

Create bulk price input

    priceIdUUIDrequired

    Price id

    Example: 293b2c42-6f6b-4414-8333-e31dccbc1c04
    valuedecimalrequired

    Discount on bulk purchases, expressed either as a percentage of the standard price or as a specific reduced price per unit, depending on the bulk price discount type

    Example: 5.35
    quantityFromnumberrequired

    Indicates the minimum quantity threshold needed to qualify for the bulk price.

    Example: 1
    validFromdate-time

    Start date from which the bulk pricing is effective. Must be a valid ISO 8601 date string

    Example: 2025-05-27T07:33:53+0000
    validTodate-time

    End date of the bulk pricing offer. Must be a valid ISO 8601 date string

    Example: 2026-01-27T07:33:53+0000

Responses

Bulk price created

Schema

    idstringrequired

    Primary identifier

    Example: 1234
    createdAtdate-timerequired

    Creation date

    Example: 2022-01-01T00:00:00.000Z
    lastModifiedAtdate-timerequired

    Last modified date

    Example: 2022-01-02T00:00:00.000Z
    validFromdate-time

    Start date from which the bulk pricing is effective. Must be a valid ISO 8601 date string

    Example: 2022-01-01T00:00:00.000Z
    validTodate-time

    End date of the bulk pricing offer. Must be a valid ISO 8601 date string

    Example: 2022-01-31T00:00:00.000Z