---
title: "Create Loyalty Plan"
description: "Use POST /loyalty_plans to create a loyalty plan. The operation documented here is LoyaltyPlan.register."
canonical: https://docs.ordering.co/api-reference/guides/create-loyalty-plan/
---

# Create Loyalty Plan

> **API operation:** [Open the endpoint in Scalar](https://docs.ordering.co/api-reference/#tag/loyalty_plans/POST/loyalty_plans)

Use `POST /loyalty_plans` to create a loyalty plan. The operation documented here is `LoyaltyPlan.register`.

The documented schema requires administrator authentication and currently requires `name`, `type`, `redemption_rate`, `accumulation_rate`, and `businesses`.

See [Loyalty plan model](https://docs.ordering.co/api-reference/guides/loyalty-level-model/) and [Business loyalty plans model](https://docs.ordering.co/api-reference/guides/business-loyalty-plans-model/).

## OpenAPI reference

**Operation:** `POST /loyalty_plans`

**Request body fields**

| Name                      | Type            | Required |
| ------------------------- | --------------- | -------- |
| `accumulation_rate`       | number          | Yes      |
| `businesses`              | array\<any>     | Yes      |
| `expire_after_minutes`    | integer \| null | No       |
| `maximum_accumulation`    | number \| null  | No       |
| `maximum_redemption_rate` | number          | No       |
| `maximum_redemption_type` | integer \| null | No       |
| `name`                    | any             | Yes      |
| `redemption_rate`         | number          | Yes      |
| `type`                    | string          | Yes      |

**Responses**

| Code | Description                           |
| ---- | ------------------------------------- |
| 200  | OK                                    |
| 400  | Bad Request (ErrorResponse)           |
| 401  | Unauthorized                          |
| 404  | Not Found                             |
| 429  | Too Many Requests (ErrorResponse)     |
| 500  | Internal Server Error (ErrorResponse) |
| 503  | Service Unavailable (ErrorResponse)   |

[Open this operation in the API reference](https://docs.ordering.co/api-reference/#tag/loyalty_plans/POST/loyalty_plans)
