Not every reward lives inside Optimove Loyalty.

External Rewards let you attach prizes that are stocked and fulfilled in your own systems — free spins, cash credits, physical prizes, or status in your own program — to missions and tournaments. Optimove Loyalty tracks the achievement and notifies your system the moment the reward is earned; you own the inventory and the fulfillment itself.

This guide will walk you through adding an External Reward to your library and attaching it to a mission or tournament.

How to Set Up an External Reward

Open External Rewards

Navigate to Optimove Loyalty → External Rewards. This opens a library view, similar to Virtual Currencies.

Add new External Reward

Select + Add Reward

Enter the Reward Details

When adding the reward, specify:

1. Enter a Title and Name — how the reward is labeled in the configurator and in the player widget.
2. Enter a Short Code — an internal string used for integrations and querying, for example, FP10 for "10 free spins".
3. Upload an Image. This is optional but recommended — without an image, the reward can't be displayed on a mission card or in the Store.

Set the Fulfillment Webhook

The webhook is how your system learns that a player has earned the reward.

1. Specify the webhook endpoint that should be notified when the reward is earned.
2. Set one general webhook as the default for all External Rewards, or a unique endpoint for a specific reward.
3. Add any custom values your internal systems require to the payload — for example, a prize_code.

For technical implementation details, see the Gamify Loyalty Webhooks guide in the Optimove Developer Hub.

Attach It to a Mission or Tournament

1. Open the mission or tournament whose rewards you want to define.
2. Click + Add Reward Type.
3. Choose External Reward and select the asset from your library.

Save & Activate

Click Save & Activate to go live.

Key Elements to Keep In Mind

• You own the inventory. Stock management for External Rewards lives entirely in your own system. Optimove Loyalty tracks that the reward was earned and notifies you via webhook — fulfillment happens on your side.
• External Rewards can also be sold in the Store, alongside Loyalty System Rewards.