arrow-leftarrow-rightbook-openbooks-duotonechalkboardhead-side-brainlife-ring-regularmenusearchstopwatchvideo
Getting Started
Elements
Styling & Customization
Flows
Checkout Settings
Automation
Billing Automation
Purchase Automations
Product Automation
Subscription Automation
Payment Plan Automation
Promotion Automation
Other Automations
Products
Subscriptions
Promotions
Order Management
Reporting & Analytics
Customer Portal
Affiliates
Integrations
ActiveCampaign
Circle
Custom Webhooks
Customer.io
Drip
FirstPromoter
Flodesk
GoHighLevel
Google
Heartbeat
Help Scout
HubSpot
Infusionsoft
Kajabi
Keap
Kit
LeadDyno
MailChimp
Make
MemberPress
Meta Pixel
Mighty Networks
Rewardful
Slack
SEGMetrics
ShipStation
Taxes
Thinkific
TikTok
Uscreen
Zapier
Zoho
AI / MCP
FAQ
API

Unique Promo Code Management

Unique Codes are individual promo codes issued to specific customers. Each customer can have only one active Unique Code at a time per Promotion.

Codes can be issued, revoked, and reissued from the Promotions dashboard, a customer record, or through automation. In this article, we’ll cover how to manage Unique Codes individually and check their validity.

Need to bulk issue, revoke, or reissue Unique Codes?
You can do this through the API or with AI/MCP.

Before you begin: You’ll need to create a Promotion that uses Unique Codes.

Issue a Unique Code

You can issue a Unique Code for a specific Promotion to a customer either manually from a customer record or the Promotions dashboard, or automatically when a customer makes a purchase.

When a Unique Code is issued to a customer, you can view it on their customer record and on the Promotions dashboard.

Unique Codes are not automatically sent to your customer. Use the Promotion Code Issued event with webhook automation to send an email or other notification to your customer with their code details.

Save time with AI. Connect your favorite AI tools to Spiffy and your other systems, then tell your AI what to set up for you. Get Started

Through Automation on a Checkout

Use automations on a Checkout to issue a Unique Code to a customer when they make a purchase. This is possible with Spiffy’s built in automation action Add to promotion.

  1. In the Checkouts Editor, click on the Automations tab on the far left
  2. Click on the blue Add Action button at the right of the canvas
  3. Choose the type of event to trigger the action
  4. Click on the Spiffy Integration
  5. Click Add to promotion
  6. Select a Promotion from the drop-down list
  7. Click Finish
  8. Publish your Checkout to make the changes live

Now, when a customer completes a purchase on the Checkout a Unique Code will be issued to that customer. If the customer has already been issued a Unique Code for that Promotion, Spiffy will not issue another one to the same customer, unless their code was revoked.

You can also set up automation on a checkout to issue a Unique Code when a customer purchases a specific item on your main checkout or takes an upsell in the checkout flow.

Learn more about Checkout-level Purchase Automations →

On a Customer Record

Manually issue a Unique Code to a customer for a specific Promotion from their customer record.

  1. Search for the customer and go to their customer record
  2. Click Add to promotion
  3. In the pop-up window, select a Promotion from the drop-down list
  4. Click Issue Code

Again, if the customer has already been issued a Unique Code for that Promotion, Spiffy will not issue another one to the same customer, unless their code was revoked.

On the Promotions Dashboard

Manually issue a Unique Code to a customer for a specific Promotion from the Promotion dashboard.

  1. Go to Promotions, and select a Unique Code Promotion from the list
  2. On the dashboard for your Promotion, click on the Issue to customer button
  3. In the pop-up window, search for the customer you want to issue a code to
  4. Click Issue Code

Revoke a Unique Code

There may be situations where you need to revoke a customer’s Unique Code for a specific Promotion. You can do this manually on the customer record or the Promotions dashboard, or automatically through a purchase on a checkout.

When a Unique Code is revoked, it is no longer valid and cannot be redeemed on an order. Revoking a code does not prevent the same customer from being issued a new Unique Code for the same Promotion in the future.

Through Automations on a Checkout

Use automations on a Checkout to revoke a customer’s Unique Code for a specific Promotion when they make a purchase. This is possible with Spiffy’s built in automation action Revoke from promotion.

  1. In the Checkouts Editor, click on the Automations tab on the far left
  2. Click on the blue Add Action button at the right of the canvas
  3. Choose the type of event to trigger the action
  4. Click on the Spiffy Integration
  5. Click Revoke from promotion
  6. Select a Promotion from the drop-down list
  7. Click Finish
  8. Publish your Checkout to make the changes live

Now, when a customer completes a purchase on the Checkout their Unique Code will be revoked, if they have an existing active code for that Promotion.

You can also set up automation on a checkout to revoke a Unique Code when a customer purchases a specific item on your main checkout or takes an upsell in the checkout flow.

Learn more about Checkout-level Purchase Automations →

On a Customer Record

Manually revoke a customer’s active Unique Code on their customer record.

  1. Search for the customer and go to their customer record
  2. Under the Promotions section, click on the code to revoke
  3. In the pop-up window, select Revoke
  4. To confirm the action, click Revoke code

You will see the revoked code listed on their record under Past Codes.

Reissue a Unique Code

Reissuing a customer’s Unique Code allows you to revoke their existing code for a specific Promotion and issue a new one in its place, all in one step.

  1. Navigate to the customer’s record
  2. Under the Promotions section, find and click on the code to reissue
  3. In the pop-up window, select Reissue
  4. To confirm the action, click Reissue

You will see the new code listed on the customer’s record, and the revoked code under Past Codes.

Only active Unique Codes can be reissued. If a code has been revoked or expired, it cannot be reissued. You must issue a new code to the customer.

Check a Unique Code

For every Unique Code that is issued, you can use the Check a code tool to see if it is eligible for use and why it will or will not work for a customer.

  1. Go to Promotions settings and click Check a code
  2. Enter the code you want to check
  3. Enter the customer to check it against (optional)
  4. Click Run checks

You can also check a code from the customer’s record. Under the Promotions section of their record, click on the code and then click Check eligibility in the pop-up window.