---
title: "Create Promo"
method: POST
path: "/api/v1/admin/promos"
---

# Create Promo

`POST /api/v1/admin/promos`

## Request

- Base URL: `https://allover.art` (the document declares no server; this is the origin it was published from)
- URL: `https://allover.art/api/v1/admin/promos`
- Auth: none declared

## Headers

- `x-admin-key` string, nullable

## Request body

- PromoIn
  - `code` string, nullable
  - `kind` string
  - `value` number, required
  - `free_shipping` boolean
  - `max_uses` integer, nullable
  - `first_order_only` boolean
  - `note` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/allover/apis/allover-art-storefront.md) · [All operations](https://skmtc.dev/allover/apis/allover-art-storefront/llms.txt) · [OpenAPI document](https://skmtc.dev/allover/apis/allover-art-storefront/revisions/6f6a2faf8135?raw)