promotion33 ops

Promotion API

Marketing campaigns, coupon codes, and gift card programs.

Queries

QUERY

adminListRedemptions

#

Redemptions of one coupon, gift card, gift-card batch or campaign, newest first (admin)

Arguments

  • input!
Returns!
QUERY

campaign

#

Get a campaign by ID

Arguments

  • id!
Returns
QUERY

campaignStatistics

#

Get campaign statistics (admin)

Arguments

  • campaignId!
Returns!
QUERY

checkGiftCardBalance

#

Check gift card balance detail. Same visibility as giftCardBalance.

Arguments

  • giftCardId!
Returns!
QUERY

coupon

#

Get a coupon by code

Arguments

  • codeString!
Returns
QUERY

couponById

#

One coupon by id (admin)

Arguments

  • id!
Returns
QUERY

couponStatistics

#

Usage and discount totals for one coupon (admin)

Arguments

  • couponId!
Returns!
QUERY

exportCampaignCodes

Deprecated#

Deprecation reason: Use exportCampaignCodesResult; BET-205

Arguments

  • input!
Returns!
QUERY

exportCampaignCodesResult

#

Export campaign coupon codes to CSV or PDF (admin)

Arguments

  • input!
Returns!
QUERY

exportGiftCards

Deprecated#

Deprecation reason: Use exportGiftCardsResult; BET-205

Arguments

  • input
Returns!
QUERY

exportGiftCardsResult

#

Export gift cards to CSV or PDF (admin)

Arguments

  • input
Returns!
QUERY

giftCardBatch

#

One gift-card batch by id (admin)

Arguments

  • id!
Returns
QUERY

giftCardBatches

#

List gift card batches (admin)

Arguments

  • input
Returns!
QUERY

giftCardBatchStatistics

#

Card counts and issued / redeemed / outstanding value for one gift-card batch (admin)

Arguments

  • batchId!
Returns!
QUERY

giftCardById

#

One gift card by id, so admin pages never put a redeemable code in a URL (admin)

Arguments

  • id!
Returns
QUERY

listCampaigns

#

List campaigns with filtering (admin)

Arguments

  • input
Returns!
QUERY

listCoupons

#

List coupons with filtering (admin)

Arguments

  • input
Returns!
QUERY

listGiftCards

#

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

Arguments

  • input
Returns!

Mutations

MUTATION

applyCoupon

Deprecated#

Apply a coupon to an order

Deprecation reason: Price coupons through createTaxiQuote(input.couponCode) before booking; BET-222

Arguments

  • input!
Returns!
MUTATION

cancelGiftCard

#

Void an active gift card (admin)

Arguments

  • giftCardId!
Returns!
MUTATION

cancelGiftCardBatch

#

Void every active card in a batch; redeemed and expired cards are left as they are (admin)

Arguments

  • batchId!
Returns!
MUTATION

createCampaign

#

Create a new campaign (admin only)

Arguments

  • input!
Returns!
MUTATION

createCoupon

#

Create a new coupon (admin only)

Arguments

  • input!
Returns!
MUTATION

deleteCampaign

#

Delete a campaign (admin only)

Arguments

  • campaignId!
ReturnsBoolean!
MUTATION

deleteCoupon

#

Delete a coupon that was never redeemed; a redeemed one is expired instead so its redemption history keeps pointing at it (admin)

Arguments

  • couponId!
Returns!
MUTATION

generateCampaignCoupons

#

Create up to 1000 unique coupon codes for a campaign from one template (admin)

Arguments

  • input!
Returns!
MUTATION

issueGiftCardBatch

#

Issue gift cards in batch (admin only)

Arguments

  • input!
Returns!
MUTATION

redeemGiftCard

#

Redeem a gift card to wallet

Arguments

  • input!
Returns!
MUTATION

sendCampaignNotification

#

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

Arguments

  • input!
Returns!
MUTATION

updateCampaign

#

Update a campaign (admin only)

Arguments

  • input!
Returns!
MUTATION

updateCoupon

#

Update a coupon's fields (admin only)

Arguments

  • input!
Returns!
MUTATION

updateCouponStatus

#

Update a coupon's status (admin only)

Arguments

  • input!
Returns!
MUTATION

updateGiftCard

#

Change an active gift card's expiry and/or message (admin)

Arguments

  • input!
Returns!