---
title: "Create new recurring period."
method: POST
path: "/api/v1/tariff-recurring-periods"
tags: ["Tariff Recurring Periods"]
---

# Create new recurring period.

`POST /api/v1/tariff-recurring-periods`

Required scope: `tariffs:write`<br/>**Note: Once you are done with creating/updating tariffs and its components you have to call the `create-prices` endpoint to create the prices for the tariff.**

## Request body

- TariffRecurringPeriodCreateRequestDto
  - `tariffId` integer, required — Id of the tariff this period will belong to
  - `groupId` integer, required — Id of the tariff period group this period will belong to
  - `dayOfWeek` 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY', required
  - `endDayOfWeek` 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY'
  - `startHour` integer, required — hour that the period starts at
  - `endHour` integer, required — hour that the period ends at
  - `price` number, required — price during the period

## Response `201`

Tariff recurring period that was created

- TariffRecurringPeriod
  - `id` integer — id of the period
  - `tariffId` integer — id of the tariff
  - `dayOfWeek` 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY', required
  - `endDayOfWeek` 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY'
  - `start` integer — starting hour of the period
  - `end` integer — ending hour of the period
  - `price` number, required — price during the period

## Other responses

- `400` — The request is invalid
- `401` — Consumer with provided credentials was not found
- `403` — Operator doesn't have access to resource
- `404` — Entity with the provided id was not found

---

[API](https://skmtc.net/monta/apis/monta-partner-api.md) · [All operations](https://skmtc.net/monta/apis/monta-partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/monta/monta-partner-api/revisions/517e18f11015/schema)