---
title: "Create a new price agreement period"
method: POST
path: "/v1/priceagreement/{id}/period"
tags: ["Create repricing agreements"]
---

# Create a new price agreement period

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

This operation will create a new price agreement period

## Path parameters

- `id` string, required

## Query parameters

- `auditUser` string, required

## Request body

- PostPriceAgreementPeriodV1ResourceBody
  - `lowest` boolean — After all logic and repricing, should the lowest price apply. I.E the repriced one or the one coming from the merchant.
  - `priceListId` string — A reference to a price list, using the id of the price list
  - `code` string — Product code for this agreement period
  - `type` 'PER_EACH' | 'ABSOLUTE' | 'PERCENT' — Tells which kind of discount calculation that applies
  - `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 connected to the `type` field above. This can be 45.4 PER_EACH, 5.0 PERCENT etc.

## Response `201`

Successfully 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/revisions/dc4a41118f80/schema)