Skip to main content
POST

Create a price list

Scope:inventory:rates.write
https://api.holded.com/api/v2/price-lists

Creates a new price list (rate). Price lists let you offer different prices to different customer segments — for example, Retail, Wholesale, or VIP. The response returns the new price list `id`.

Request body

object
namestringrequired

Display name for the price list

descriptionstring | nulloptional

Optional description

Request

python
import requests

url = "https://api.holded.com/api/v2/price-lists"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

payload = {
    "name": "string",
    "description": "string"
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())

Responses

Response

json
{
  "id": "507f1f77bcf86cd799439011"
}

Success responses

201Price list createdapplication/json
object
idstring

Error responses

400Bad requestapplication/json
401Invalid or missing API keyapplication/json
403Insufficient permissionsapplication/json
422Validation errorapplication/json