---
title: "Create a promotion (admin only)"
method: POST
path: "/api/admin/promotions"
tags: ["Admin - Promotions"]
---

# Create a promotion (admin only)

`POST /api/admin/promotions`

## Request

- Base URL: `https://api.rewritelifestyle.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.rewritelifestyle.ai/api/admin/promotions`
- Auth: HTTP bearer

## Request body `multipart/form-data`

- CreatePromotionDto
  - `title` string
  - `forward_url` string, required
  - `start_at` string, required
  - `end_at` string, required
  - `priority` number
  - `is_active` boolean
  - `countries` string[]
  - `roles` string[]
  - `subscription_statuses` string[]
  - `group_ids` string[]

## Response `201`

---

[API](https://skmtc.dev/rewritelifestyle/apis/rewrite-lifestyle-api.md) - [All operations](https://skmtc.dev/rewritelifestyle/apis/rewrite-lifestyle-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rewritelifestyle/apis/rewrite-lifestyle-api/revisions/28695827f27a?raw)