<!--
canonical_url: https://university.spiffy.co/promotions/unique-promo-code-management/
post_id: 13952
post_type: post
last_modified: 2026-11-17T18:38:14+00:00
generated_at: 2026-11-17T18:38:14+00:00
-->

# 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](https://developers.spiffy.co/api/promotions) or with [AI/MCP](https://university.spiffy.co/ai-mcp/getting-started-with-mcp.md).

**Before you begin:** You’ll need to create a [Promotion](https://university.spiffy.co/wp-admin/post.php?action=edit&post=13679) that uses Unique Codes.

- [Issue a Unique Code](#issue-a-unique-code)
- [Revoke a Unique Code](#revoke-a-unique-code)
- [Reissue a Unique Code](#reissue-a-unique-code)
- [Check a Unique Code](#check-a-unique-code)

## 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](https://university.spiffy.co/wp-admin/post.php?post=13958&action=edit) 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](https://university.spiffy.co/ai-mcp/getting-started-with-mcp.md)

### 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 →](https://university.spiffy.co/automation/purchase-automation/purchase-automations.md)

### 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 →](https://university.spiffy.co/automation/purchase-automation/purchase-automations.md)

### 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.
