---
title: "Grant Premium To Email"
method: POST
path: "/api/v1/admin/promo/grant"
tags: ["Admin - Promo Codes", "Admin - Promo Codes"]
---

# Grant Premium To Email

`POST /api/v1/admin/promo/grant`

## Request

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

Comp an email address.

If they already have an account, premium turns on immediately. If not, the
returned code is reserved for that address and applies the moment they sign
up — so an outreach reply can be honoured before the person exists as a user.

## Headers

- `x-admin-key` string, nullable

## Request body

- PromoGrantRequest
  - `email` string, required: Address to comp
  - `premium_days` integer, nullable: null = lifetime
  - `note` string, nullable
  - `campaign` string, nullable

## Response `200`

Successful Response

- PromoGrantResponse
  - `code` string, required
  - `email` string, required
  - `applied` boolean, required
  - `user_id` integer, nullable
  - `premium_until` string, date-time, nullable
  - `message` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/gemstoneaiapp/apis/gemstoneai-api.md) · [All operations](https://skmtc.dev/gemstoneaiapp/apis/gemstoneai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gemstoneaiapp/apis/gemstoneai-api/revisions/fcb441f55161?raw)