---
title: "🔒 Create sales price V3"
method: POST
path: "/api/v3/salesPrices"
tags: ["SalesPrice"]
---

# 🔒 Create sales price V3

`POST /api/v3/salesPrices`

This endpoint is currently in Beta and available for testing. It may contain bugs, and breaking changes can occur at any time without prior notice. We do not recommend using Beta endpoints in production environments. Should you choose to use it in production, you assume full responsibility for any resulting issues.

This endpoint requires the following scopes: `salesPrice:create`.

Create a new sales price.

## Request body

- object — SalesPrice create payload
  - `product` object, required — Product
    - `id` string — Product ID
  - `customer` object — Customer (provide either customer or customerGroup, but not both)
    - `id` string — Customer ID
  - `customerGroup` object — Customer group (provide either customer or customerGroup, but not both)
    - `id` string — Customer group ID
  - `price` object, required — Money
    - `amount` union
      - string
      - number
    - `currency` string — Currency
  - `quantity` number, float, required — Quantity
  - `packageAmount` unknown
  - `customerProductNumber` string — Customer product number
  - `isNotCalculatedFromExchangeTable` boolean — Whether the price is not calculated from exchange table
  - `hideInBulkPriceListing` boolean — Whether to hide the price from bulk price listing
  - `remark` string — Remark
  - `validFrom` string, date — Valid from date
  - `expiresAt` string, date — Expires at date

## Response `201`

Create a new sales price.

- object
  - `data` object — SalesPrice view
    - `id` string — SalesPrice ID
    - `product` object — Product
      - `id` string — Product ID
    - `customer` object — Customer
      - `id` string — Customer ID
    - `customerGroup` object — Customer group
      - `id` string — Customer group ID
    - `price` object — Money
      - `amount` union
        - string
        - number
      - `currency` string — Currency
    - `amount` number, float — Amount
    - `packageAmount` unknown
    - `customerProductNumber` string — Customer product number
    - `isNotCalculatedFromExchangeTable` boolean — Whether is calculated from exchange table
    - `hideInBulkPriceListing` boolean — Whether to hide from bulk price listing
    - `remark` string — Remark
    - `validFrom` string, date — Valid from date
    - `expiresAt` string, date — Expires at date

## Other responses

- `400` — Failed validation
- `401` — Unauthorized
- `403` — Forbidden
- `429` — Too Many Requests

---

[API](https://skmtc.net/xentral/apis/xentral-api.md) · [All operations](https://skmtc.net/xentral/apis/xentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/xentral/xentral-api/revisions/8a27ba392442/schema)