---
title: "Create a plan"
method: POST
path: "/v1/plans"
tags: ["PLANS"]
---

# Create a plan

`POST /v1/plans`

## Request

- Base URL: `https://sandbox.dev.clover.com/recurring`
- URL: `https://sandbox.dev.clover.com/recurring/v1/plans`
- Auth: HTTP bearer

Creates a merchant plan that customers can use to initiate automatic payments. Each plan defines a fixed amount, periodic frequency, tax, convenience fees, tips, and so on. You can create as many recurring payment plans as required.

## Headers

- `X-Clover-Merchant-Id` string, required
- `User-Agent` string, required

## Request body

- object
  - `name` string, required: Plan name. Cannot be null or blank. Length: Minimum 3 characters; Maximum 127 characters
  - `amount` integer, required: Plan amount.
  - `note` string: Additional information or note related to the plan.
  - `taxRateUuids` string[]: Tax rate universally unique identifier (UUID). Use the Get all tax rates endpoint to retrieve merchant tax UUID information. Length: Maximum length of combined UUIDs is 255 characters.
  - `tipAmount` integer: Amount paid in tips.
  - `interval` 'DAY' | 'WEEK' | 'MONTH' | 'YEAR', required: Interval of the plan. Values: - Day - Week - Month - Year
  - `intervalCount` integer, required: Number of intervals in the plan.

## Response `200`

Successful response. A set of merchant plans is created.

- object
  - `id` string: Plan identifier.
  - `name` string: Plan name.
  - `merchantId` string: Merchant identifier.
  - `taxRateUuids` string[]: Tax rate universally unique identifiers (UUIDs).
  - `tipAmount` string: Tip amount.
  - `amount` string: Plan amount.
  - `active` boolean: Indicates whether the plan is active. Values: - True - False
  - `interval` 'DAY' | 'MONTH' | 'WEEK' | 'YEAR': Plan interval. Example: Daily, weekly, semi-monthly, monthly, quarterly, yearly. See [Interval Matrix table]( https://docs.clover.com/docs/working-with-recurring-payments-and-subscriptions#interval-matrix) for details.
  - `intervalCount` integer: Number of times the plan interval occurs.
  - `productUuid` string: Product universally unique identifier (UUID).
  - `note` string: Additional information or note related to the plan.
  - `createdTime` string, date-time: Time when the plan was created.
  - `modifiedTime` string, date-time: Time when the plan was modified.
  - `deletedTime` string, date-time: Time when the plan was deleted.
  - `subscriptionCount` integer: Number of subscriptions in the plan.
  - `subscriptionPaidTotalAmount` integer: Total paid amount for subscriptions in the plan.
  - `lastRunDate` string, date-time: Last run date for the plan.
  - `object` string

## Other responses

- `default`: Unexpected error.

---

[API](https://skmtc.dev/clover/apis/ecommerce-recurring-apis.md) - [All operations](https://skmtc.dev/clover/apis/ecommerce-recurring-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/clover/apis/ecommerce-recurring-apis/revisions/c49bc4a5e5ed?raw)