---
title: "Add new billing cycle definition"
method: POST
path: "/settings/billingCycle"
tags: ["Settings"]
---

# Add new billing cycle definition

`POST /settings/billingCycle`

## Request

- Base URL: `https://api.app.subskribe.com`
- URL: `https://api.app.subskribe.com/settings/billingCycle`
- Auth: API key in header `X-API-Key`

## Request body

- BillingCycleDefinitionAdd
  - `name` string
  - `recurrence` RecurrenceJson
    - `cycle` 'DAY' | 'MONTH' | 'QUARTER' | 'SEMI_ANNUAL' | 'YEAR' | 'PAID_IN_FULL' | 'CUSTOM', required
    - `step` integer, required
  - `status` 'ACTIVE' | 'INACTIVE'

## Response `default`

successful operation

---

[API](https://skmtc.dev/dealhub/apis/subskribe-api.md) - [All operations](https://skmtc.dev/dealhub/apis/subskribe-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dealhub/apis/subskribe-api/revisions/c1ee531b82ce?raw)