---
title: "Create a new price list period"
method: POST
path: "/v1/pricelist/{id}/period"
tags: ["Create price lists"]
---

# Create a new price list period

`POST /v1/pricelist/{id}/period`

This operation will create a new price list period for the provided price list id

## Path parameters

- `id` string, required

## Query parameters

- `auditUser` string, required

## Request body

- BasePriceListPeriod
  - `validFrom` string, date-time — The RFC 3339 format date and time from what time the price list should be active. Cannot be null
  - `validTo` string, date-time — The RFC 3339 format date and time when this price list should stop to be active. Cannot be greater than 'validFrom' of any other price list with the same 'code'. Can be null, which means this price list is active until this field is set
  - `value` number — The value of the price

## Response `201`

Successful created

- ResourceResponse
  - `description` string — Short description of the result of the action
  - `id` string — Will contain the ID of the resource that has been created or updated

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal server error

---

[API](https://skmtc.net/enfuce/apis/transfer-api.md) · [All operations](https://skmtc.net/enfuce/apis/transfer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/enfuce/transfer-api/versions/dc4a41118f80/schema)