Promotion API

List all active campaigns for the current tenant

List all active coupons for the current tenant

Get a campaign by ID

List coupon codes for a campaign with pagination (admin)

Get campaign statistics (admin)

Check gift card balance detail

Get a coupon by code

Export campaign coupon codes to CSV or PDF (admin)

Export gift cards to CSV or PDF (admin)

Get a gift card by code

Get gift card balance

List gift card batches (admin)

List campaigns with filtering (admin)

List coupons with filtering (admin)

List gift cards with pagination, filtering, and sorting (admin)

List gift cards for the current account

Apply a coupon to an order

Create a new campaign (admin only)

Create a new coupon (admin only)

Create referral coupons (triggered by referral events)

Delete a campaign (admin only)

Issue a new gift card (admin only)

Issue gift cards in batch (admin only)

Redeem a gift card to wallet

Send campaign notifications manually (admin only) Allows sending notifications for active campaigns: - For campaigns that didn't auto-send on activation - For re-sending notifications (e.g., follow-up reminders) - With optional delivery channel overrides

Update a campaign (admin only)

Update a coupon's fields (admin only)

Update a coupon's status (admin only)