---
title: "Create Product Rate"
method: POST
path: "/productRates"
tags: ["Products / Rates"]
---

# Create Product Rate

`POST /productRates`

## Request

- Base URL: `https://api.forcemanager.com/api/v4`
- URL: `https://api.forcemanager.com/api/v4/productRates`
- Auth: API key in header `X-Session-Key`

This endpoint allows you to create a Product Rate based on JSON input.

You will only be able to create a Product Rate after first providing the Session Key. To know how you can obtain the Session Key, [go to Authentication](#tag/authentication/POST/login).

**HEADERS**

| **Parameter** | **Value** | **Description** |
| --- | --- | --- |
| Content-Type | application/json | Language in which all request and response bodies are encoded |
| Accept | \*/\* | Any data of whatever mime type is accepted |
| X-Session-Key | AUTH_TOKEN | This field must be completed with the token obtained at the authentication |

**REQUEST BODY**

| **Attribute** | **Type** | **Description** |
| --- | --- | --- |
| costPrice | Number | Cost that can be applied to the Product |
| discount1 | Number | First discount that can be applied to the Product, in percents |
| discount2 | Number | Second discount that can be applied to the Product, in percents |
| discount3 | Number | Third discount that can be applied to the Product, in percents |
| discount4 | Number | Fourth discount that can be applied to the Product, in percents |
| productId (*Required*) | Object, Null | ID of the Product to be associated with the Rate (see [Products](#) resource) |
| rateId (*Required*) | Object, Null | ID of the Rate to be associated with the Product (see [Rates](#) resource) |
| salePrice | Number | Price that can be applied to the Product |
| tempBuyingPrice | Number |  |
| tempListedPrice | Number |  |

**RESPONSE**  
Returns a JSON with information about the Product Rate just created.

| **Attribute** | **Type** |
| --- | --- |
| Id | Id assigned to the new Product Rate |
| Message | The operation status |

**RESPONSE CODES**

| **Status** | **Description** |
| --- | --- |
| 200 OK | Shows if operation succeeded |
| 400 Bad Request | Shows when an invalid request or the requested service is not available |

## Headers

- `Accept` string

## Request body

- object
  - `costPrice` integer
  - `discount1` integer
  - `discount2` integer
  - `discount3` integer
  - `discount4` integer
  - `productId` integer
  - `rateId` integer
  - `salePrice` integer
  - `tempBuyingPrice` integer
  - `tempListedPrice` integer

## Response `200`

Create Product Rate

---

[API](https://skmtc.dev/forcemanager/apis/sage-sales-management-public-api-documentation-for-developer.md) · [All operations](https://skmtc.dev/forcemanager/apis/sage-sales-management-public-api-documentation-for-developer/llms.txt) · [OpenAPI document](https://skmtc.dev/forcemanager/apis/sage-sales-management-public-api-documentation-for-developer/revisions/87db17204e2f?raw)