Create Discount Code Skill

Purpose: Fast discount code creation for marketing and promotions

What This Skill Does

Creates discount codes in Lemon Squeezy with:

Code name (e.g., LAUNCH50, BETA2026)
Discount type (percentage or fixed amount)
Discount amount (e.g., 50% off or $5 off)
Usage limits (total redemptions, per-customer limit)
Expiry date (optional)
Product restrictions (all products or specific ones)

When to Use This Skill

Common use cases:

Launch promotions: "Create LAUNCH50 for 50% off"
Beta reader rewards: "Create BETA100 for 100% off, limit 20"
Podcast appearances: "Create PODCAST30 for 30% off"
Social media giveaways: "Create GIVEAWAY for free access"
Seasonal sales: "Create HOLIDAY25 for 25% off"
Affiliate codes: "Create PARTNER20 for 20% off"

API Authentication

Uses LEMON_SQUEEZY_API_KEY and LEMON_SQUEEZY_STORE_ID environment variables.

Usage Examples

Example 1: Launch promotion

User: Create a 50% off code called LAUNCH50, limit 100 uses, expires in 7 days
Assistant: [Uses create-discount-code skill]

Example 2: Beta reader reward

User: Create BETA2026 for 100% off, limit to 20 people
Assistant: [Creates free code with redemption limit]

Example 3: Podcast appearance

User: I'm on a podcast next week. Create a 30% discount code
Assistant: [Creates PODCAST30 code, suggests expiry date]

Implementation

Create Discount Code API

Endpoint: POST https://api.lemonsqueezy.com/v1/discounts

Required fields:

store_id - Your store ID
name - Internal name (e.g., "Launch 50% Off")
code - The actual code users type (e.g., "LAUNCH50")
amount - Discount amount (percentage: 1-100, or cents for fixed)
amount_type - "percent" or "fixed"

Optional fields:

duration - "once", "repeating", or "forever"
duration_in_months - How many months (for repeating)
starts_at - When code becomes active (ISO 8601)
expires_at - When code expires (ISO 8601)
max_redemptions - Total usage limit (null = unlimited)
limit_redemptions_per_customer - Per-customer limit
is_limited_to_products - true/false
product_ids - Array of product IDs (if limited)

Example request (50% off, 7 days, 100 uses):

bash

curl -X POST "https://api.lemonsqueezy.com/v1/discounts" \
  -H "Accept: application/vnd.api+json" \
  -H "Content-Type: application/vnd.api+json" \
  -H "Authorization: Bearer $LEMON_SQUEEZY_API_KEY" \
  -d '{
    "data": {
      "type": "discounts",
      "attributes": {
        "store_id": YOUR_STORE_ID,
        "name": "Launch Week Promotion",
        "code": "LAUNCH50",
        "amount": 50,
        "amount_type": "percent",
        "duration": "once",
        "max_redemptions": 100,
        "expires_at": "2026-01-12T23:59:59Z"
      }
    }
  }'

Example request (100% off, beta readers):

bash

curl -X POST "https://api.lemonsqueezy.com/v1/discounts" \
  -H "Accept: application/vnd.api+json" \
  -H "Content-Type: application/vnd.api+json" \
  -H "Authorization: Bearer $LEMON_SQUEEZY_API_KEY" \
  -d '{
    "data": {
      "type": "discounts",
      "attributes": {
        "store_id": YOUR_STORE_ID,
        "name": "Beta Reader Reward",
        "code": "BETA2026",
        "amount": 100,
        "amount_type": "percent",
        "duration": "once",
        "max_redemptions": 20
      }
    }
  }'

Example request ($5 off, fixed amount):

bash

curl -X POST "https://api.lemonsqueezy.com/v1/discounts" \
  -H "Accept: application/vnd.api+json" \
  -H "Content-Type: application/vnd.api+json" \
  -H "Authorization: Bearer $LEMON_SQUEEZY_API_KEY" \
  -d '{
    "data": {
      "type": "discounts",
      "attributes": {
        "store_id": YOUR_STORE_ID,
        "name": "Five Dollar Discount",
        "code": "SAVE5",
        "amount": 500,
        "amount_type": "fixed",
        "duration": "once"
      }
    }
  }'

Response structure:

json

{
  "data": {
    "type": "discounts",
    "id": "12345",
    "attributes": {
      "store_id": 12345,
      "name": "Launch Week Promotion",
      "code": "LAUNCH50",
      "amount": 50,
      "amount_type": "percent",
      "status": "published",
      "status_formatted": "Published",
      "duration": "once",
      "duration_in_months": null,
      "is_limited_redemptions": true,
      "max_redemptions": 100,
      "redemptions_count": 0,
      "is_limited_to_products": false,
      "starts_at": null,
      "expires_at": "2026-01-12T23:59:59.000000Z",
      "test_mode": false,
      "created_at": "2026-01-05T10:00:00.000000Z",
      "updated_at": "2026-01-05T10:00:00.000000Z"
    }
  }
}

Discount Code Templates

Template 1: Launch Promotion

json

{
  "name": "Launch Week - 50% Off",
  "code": "LAUNCH50",
  "amount": 50,
  "amount_type": "percent",
  "duration": "once",
  "max_redemptions": 100,
  "expires_at": "+7 days"
}

Use case: Product launch, podcast appearance, press coverage

Template 2: Beta Reader / Reviewer

json

{
  "name": "Beta Reader Reward",
  "code": "BETA100",
  "amount": 100,
  "amount_type": "percent",
  "duration": "once",
  "max_redemptions": 20,
  "expires_at": null
}

Use case: Beta readers, reviewers, influencers Cost: $0 (100% discount codes are free)

Template 3: Early Bird

json

{
  "name": "Early Bird Special",
  "code": "EARLYBIRD",
  "amount": 30,
  "amount_type": "percent",
  "duration": "once",
  "max_redemptions": 500,
  "expires_at": "+30 days"
}

Use case: Pre-launch list, early supporters

Template 4: Seasonal Sale

json

{
  "name": "End of Financial Year Sale",
  "code": "EOFY25",
  "amount": 25,
  "amount_type": "percent",
  "duration": "once",
  "max_redemptions": null,
  "starts_at": "2026-06-01T00:00:00Z",
  "expires_at": "2026-06-30T23:59:59Z"
}

Use case: Holiday sales, seasonal promotions

Template 5: Affiliate / Partner

json

{
  "name": "Partner Discount",
  "code": "PARTNER20",
  "amount": 20,
  "amount_type": "percent",
  "duration": "once",
  "max_redemptions": null,
  "expires_at": null
}

Use case: Ongoing affiliate codes (track with unique codes per partner)

Template 6: First-Time Customer

json

{
  "name": "Welcome Discount",
  "code": "WELCOME10",
  "amount": 10,
  "amount_type": "percent",
  "duration": "once",
  "limit_redemptions_per_customer": 1
}

Use case: Email capture, welcome series

Template 7: Fixed Amount Off

json

{
  "name": "Five Dollar Discount",
  "code": "SAVE5",
  "amount": 500,
  "amount_type": "fixed",
  "duration": "once"
}

Note: Amount is in cents (500 = $5.00)

Output Format

After creating a discount code, present results like this:

markdown

# ✅ Discount Code Created

## Code Details

**Code:** `LAUNCH50`
**Type:** 50% off
**Status:** Active ✅

## Usage

**Share this with customers:**
> Use code **LAUNCH50** at checkout for 50% off!
> Valid until January 12, 2026
> Limited to first 100 customers

**Checkout URL with code:**
https://your-store.lemonsqueezy.com/checkout/buy/PRODUCT_ID?checkout[discount_code]=LAUNCH50

## Limits

- **Max uses:** 100
- **Uses so far:** 0
- **Expires:** January 12, 2026 at 11:59 PM
- **Per-customer limit:** Unlimited

## Tracking

View redemptions: https://app.lemonsqueezy.com/discounts/12345

## Update/Delete

- Edit code: Use Lemon Squeezy dashboard
- Delete code: `DELETE /v1/discounts/12345`
- Disable code: Change status to "draft"

---

## 🎯 Marketing Copy (Ready to Use)

**Social media:**

🎉 Launch Week Special! Get 50% off with code LAUNCH50 Limited to first 100 customers. Ends Jan 12. [Your checkout link]


**Email:**

Subject: [Launch Week] 50% Off Inside 🚀

Hi there,

To celebrate our launch, I'm offering 50% off to the first 100 customers.

Use code LAUNCH50 at checkout.

This offer expires January 12, so don't miss out!

[CTA Button: Get 50% Off]


**Podcast/Video mention:**

"If you want to grab a copy, I've created a special code for listeners: LAUNCH50 - that's L-A-U-N-C-H-5-0 for 50% off. It's good for the first 100 people and expires next week."

Date/Time Helpers

Common expiry patterns:

bash

# 7 days from now
expires_at=$(date -u -d "+7 days" +"%Y-%m-%dT23:59:59Z")

# End of month
expires_at=$(date -u -d "$(date +%Y-%m-01) +1 month -1 day" +"%Y-%m-%dT23:59:59Z")

# Specific date
expires_at="2026-06-30T23:59:59Z"

# No expiry
expires_at=null

Common start dates:

bash

# Start immediately
starts_at=null

# Start tomorrow
starts_at=$(date -u -d "+1 day" +"%Y-%m-%dT00:00:00Z")

# Start specific date
starts_at="2026-06-01T00:00:00Z"

Validation Rules

Code format:

2-256 characters
Letters, numbers, hyphens, underscores
Case-insensitive (LAUNCH50 = launch50)
No spaces

Amount limits:

Percentage: 1-100
Fixed: Any positive integer (in cents)

Redemption limits:

null = unlimited
Must be positive integer

Product restrictions:

json

{
  "is_limited_to_products": true,
  "product_ids": [123, 456]
}

Error Handling

Code already exists:

markdown

❌ Error: Code "LAUNCH50" already exists

Existing code details:
- Created: January 1, 2026
- Uses: 45/100
- Status: Active

Options:
1. Choose different code (e.g., LAUNCH50B)
2. Delete old code and recreate
3. Edit existing code in dashboard

Invalid amount:

markdown

❌ Error: Invalid discount amount

For percentage: Must be 1-100
For fixed: Must be positive integer in cents (e.g., 500 = $5)

You provided: 150% (invalid)
Did you mean: 50% off?

Store ID missing:

markdown

❌ Error: LEMON_SQUEEZY_STORE_ID not configured

Set in Cloudflare:
npx wrangler pages secret put LEMON_SQUEEZY_STORE_ID

Security Considerations

Don't create codes that:

Give >90% off publicly (reserve 100% for targeted use)
Have no expiry and no limit (cost control)
Are too generic (CODE, DISCOUNT, SALE)

Do:

Set reasonable limits (100-500 uses)
Use expiry dates for time-bound promos
Track usage regularly
Use unique codes per channel (track which works)

Bulk Creation

Create multiple codes at once:

bash

# Example: Create 10 unique affiliate codes
for i in {1..10}; do
  curl -X POST "https://api.lemonsqueezy.com/v1/discounts" \
    -H "Authorization: Bearer $API_KEY" \
    -d '{
      "data": {
        "type": "discounts",
        "attributes": {
          "store_id": STORE_ID,
          "name": "Affiliate Code '$i'",
          "code": "AFFILIATE'$i'",
          "amount": 20,
          "amount_type": "percent"
        }
      }
    }'
done

Analytics Integration

Track code performance:

Create unique codes per channel:
- PODCAST30 (podcast)
- TWITTER30 (Twitter)
- EMAIL30 (email list)
Compare redemptions:

markdown

Channel Performance (30% off codes):
- PODCAST30: 45 uses
- TWITTER30: 23 uses
- EMAIL30: 67 uses

Winner: Email (67 conversions)

Related Skills

/sales-dashboard - See discount usage in revenue reports
/customer-lookup - Check if customer used discount
List all discounts: GET /v1/discounts?filter[store_id]=STORE_ID

API Documentation

Full Lemon Squeezy Discounts API:

Testing

Test discount codes:

Create code in test mode:

json

{
  "test_mode": true,
  "code": "TEST50",
  "amount": 50,
  "amount_type": "percent"
}

Use in checkout with test card:
- Card: 4242 4242 4242 4242
- Expiry: Any future date
- CVC: Any 3 digits
Verify discount applied correctly
Check redemption count increased

Search AI Tools

create-discount-code

Install this agent skill to your Project

SKILL.md

Create Discount Code Skill

What This Skill Does

When to Use This Skill

API Authentication

Usage Examples

Implementation

Create Discount Code API

Discount Code Templates

Template 1: Launch Promotion

Template 2: Beta Reader / Reviewer

Template 3: Early Bird

Template 4: Seasonal Sale

Template 5: Affiliate / Partner

Template 6: First-Time Customer

Template 7: Fixed Amount Off

Output Format

Date/Time Helpers

Validation Rules

Error Handling

Security Considerations

Bulk Creation

Analytics Integration

Related Skills

API Documentation

Testing