---
title: "Create price schedule"
method: POST
path: "/api/products/{productId}/schedules"
tags: ["Products / Schedules"]
---

# Create price schedule

`POST /api/products/{productId}/schedules`

## Request

- Base URL: `https://api.payware.eu`
- URL: `https://api.payware.eu/api/products/{productId}/schedules`
- Auth: HTTP bearer

Creates a new price schedule for a product with time-constrained pricing (discounts or increments)

## Path parameters

- `productId` string, required

## Request body

- ScheduleRequest
  - `id` integer
  - `productId` string
  - `description` string
  - `priceCorrection` string
  - `correctionType` string
  - `correctionValue` string
  - `dateFrom` string
  - `dateTo` string

## Response `201`

Schedule created successfully

## Other responses

- `400`: Invalid schedule data
- `401`: Unauthorized
- `403`: Forbidden - the caller is authenticated but not permitted (plan or capability gate, KYC state, or tenant scope)
- `404`: Product not found
- `429`: Too many requests - the caller exceeded its per-partner rate limit. Carries errorCode ERR_RATE_LIMIT_EXCEEDED and a Retry-After header, in seconds. The request was not processed, so the identical request is safe to retry once the window has passed.
- `500`: Internal server error

---

[API](https://skmtc.dev/payware/apis/payware-api.md) · [All operations](https://skmtc.dev/payware/apis/payware-api/llms.txt) · [OpenAPI document](https://skmtc.dev/payware/apis/payware-api/revisions/7b3352ca947b?raw)