For the complete documentation index, see llms.txt. This page is also available as Markdown.

Coupon code lists

Path: Settings > Messaging & Content > Coupon Code Lists

Use Coupon Code Lists to upload, distribute, and track campaign codes.

What you can do

  • Create a fixed code or upload a list of unique codes.

  • Deliver codes through SMS, push notifications, and supported campaigns.

  • Export assignments and review a user's coupon history.

spinner

Create a coupon list

Open Coupon Code Lists

Go to Settings > Messaging & Content > Coupon Code Lists.

The dashboard displays an overview of all existing lists. Each list shows:

  • List Name

  • Available Coupons (remaining quantity)

  • Expiry Date

  • Actions

Use this page to track inventory and plan replenishment before campaigns run out of codes.

Click Upload Coupon Code List to start a new list.

Upload a new coupon code list

Enter a name that describes the purpose of the list. This name appears on the dashboard.

Choose a coupon type

Choose one of these coupon types:

Fixed coupon code

Use a single code for all users. This works well for sitewide promotions or general discount campaigns.

  1. Select Fixed Coupon Code.

  2. Enter the coupon value. For example, SALE10.

  3. Enter how many times this code can be assigned.

Use this option for sitewide discounts, welcome offers, or seasonal promotions.

Coupon list (unique codes)

Use a list of individual, unique codes. Each code is assigned once per user.

Prepare your file like this:

  • Use a .txt file.

  • Add one code per line.

  • Do not add commas or extra formatting.

Netmera assigns these codes sequentially and marks each code as used after assignment.

Use this option for one-time gift codes, limited allocations, or high-value promotions.

Set the warning limit

Set a threshold to receive email alerts when a list is running low.

  • When remaining codes drop below your threshold, Netmera emails the assigned recipients.

  • This helps prevent campaigns from running out unexpectedly.

For example, if Warning Limit is 50, Netmera sends a warning email when the remaining codes reach 50.

Set the expiry date

Set the final date when the coupon codes can be used.

After the expiry date:

  • Codes are automatically considered invalid.

  • Slices or widgets that depend on this list may become inactive.

  • Related automated campaigns may complete automatically.

After you complete the list settings, finish the upload flow to create the list. The new list appears on the Coupon Code Lists page with its remaining quantity, expiry date, and available actions.

Send coupon codes as transactional messages

After uploading your coupon list, you can automatically send coupon codes using:

  • SMS

  • Push Notification

Enable either option when your campaign needs automatic delivery.

Before enabling delivery, create active Transactional Messaging messages for SMS or push notifications. Add {couponcode} and {expirydate} to the message body. Then map these fields in Coupon Code Lists, as shown below.

Send SMS

  • SMS delivery uses predefined active transactional messages.

  • Insert {couponcode} and {expirydate}.

  • Create the profile attributes used in the transactional message first.

  • Complete the SMS integration before using this option.

Send push notifications

  • Push notifications also use predefined active transactional messages.

  • Insert {couponcode} and {expirydate}.

  • Create the profile attributes used in the transactional message first.

Use coupon codes in campaigns

Add a coupon list to supported campaign types after creating it.

Coupon codes can be used in campaigns and widgets:

Add a coupon list

  1. Go to Messages > Campaigns.

  2. Enter a campaign name and select SMS, Push Notification, or Email.

  3. Go to the What step.

  4. Select a coupon list from Coupon Code.

Complete channel-specific setup

Choose the branch for your campaign type.

SMS

  1. Enable Personalized Message.

  2. Select your Coupon Code and click Add.

The selected coupon code is added to the personalized SMS message as a coupon parameter.

Add a coupon list to a personalized SMS message.

Push notification

  1. Enable Personalized Message.

  2. Select your Coupon Code and click Add.

Select a coupon code list from Coupon Code

Email

  1. Enable Personalized Message.

  2. Select your Coupon Code and click Copy.

  3. Paste the coupon parameter into the Mail Subject, Mail Preheader, or the email content.

Copy the coupon parameter for an email campaign.
Paste the coupon parameter into a supported email field.

Handle unavailable codes

If a coupon code is unavailable, choose a behavior under When any of the parameters is null:

  • Do not send message — The notification is not sent when a coupon code cannot be assigned.

  • Send notification message — The standard notification message is sent without the personalized coupon code.

Use Do not send message when the offer depends on a valid coupon. Use Send notification message when you want the campaign to continue even if the coupon inventory is exhausted.

Choose how the campaign continues when a coupon code is unavailable.

Understand distribution rules

Netmera applies coupon distribution rules at the campaign level. A user can receive only one coupon code from the same campaign ID within 24 hours. If the same campaign triggers again during that period, Netmera sends the same code instead of assigning a new one.

This rule prevents over-delivery and keeps coupon usage consistent across repeated triggers.

Netmera also marks connected campaigns as Finished automatically when the coupon list can no longer distribute valid codes.

Campaigns finish automatically in these cases:

  • The list is empty and all codes are used.

  • The coupon list reaches its expiry date.

This behavior applies to all features that use coupon lists, including:

  • Spin to Win

  • Copy Button

  • Any widget that distributes coupon codes

Manage coupon lists

Edit a coupon list

  1. Go to Coupon Code Lists.

  2. Click Edit.

You can update:

  • Expiry date, Coupon file (.txt), Fixed coupon details

This supports long-running campaigns without creating new lists.

Analyze the results

Track assigned codes

You can export a coupon code list to review which coupon codes were assigned to users.

The exported data can be used together with the user’s External ID to identify which coupon code was assigned to each user.

When a coupon code is assigned, Netmera also records a Coupon Code Assigned event. This event can be used to track coupon assignment activity for the user.

Exporting a coupon code to review assigned coupon codes.

Export coupon usage

To export assigned coupon data:

  1. Open Coupon Code Lists.

  2. Click Export.

Your export includes:

  • Coupon Code, External ID, User ID, Coupon Given Date, Coupon Expiry Date

Review a user's assigned codes

Go to Targeting > User Details > Coupon Codes.

This page displays:

  • All coupon codes assigned to a user

  • When each code was delivered

  • Full coupon history

Use this view for customer support, segmentation, and troubleshooting.

FAQs

Can Netmera generate coupon codes?

No. Netmera only manages and distributes the codes you upload.

Is there a limit to how many codes I can upload?

There is no strict limit. Large uploads are supported within system capacity.

Is there a limit to the number of coupon lists?

No. You can create as many lists as your campaigns require.

What file format should I use for uploading codes?

Use a .txt file with one code per line.

What happens when a coupon list runs out of codes?

Netmera follows the fallback behavior you selected for unavailable codes. Connected campaigns finish automatically when the list can no longer distribute valid codes.

Can the same user receive multiple coupon codes?

A user receives one code from the same campaign ID within 24 hours. Repeat triggers send the same code. After 24 hours, the user can receive a new code.

Where can I review assigned coupon codes?

Export the coupon list for assignment data. You can also open Targeting > User Details > Coupon Codes for a user's history.

Last updated

Was this helpful?