Creating a Basic Promotion
This guide covers the fundamental process in OptiPromo: creating a basic promotion and attaching a reusable promo code to it. In many marketing scenarios, a simple, one-time reward mechanism is enough to incentivize users, and this flow is designed for exactly that.
This setup is particularly useful when:
- You want to launch a quick bonus or offer campaign with a shared code (e.g.,
WELCOME2025
). - You need a reliable and reusable promotional link between your internal system and OptiPromo for seamless execution within Optimove's Campaign Builder.
Completing these steps is a foundational prerequisite before you can add more advanced features like metadata, budget limits, or conditional tiers.
Prerequisites
Before you begin, ensure you have:
- A valid Optimove API Key.
- Familiarity with sending
POST
requests to an API.
The Two-Step Process
To create and assign a basic promotion, you will now make two sequential API calls.
1. Create the Promotion
First, send a POST
request to the /promotions
endpoint to define the core promotion entity. You will receive a promotionId
in the response, which you will need for the next step.
2. Create the Promocode & Assign
Next, send a POST
request to create the promocode. Crucially, you must include the promotionId
you received from Step 1 in the body of this request. This action creates the promocode and assigns it to the promotion in a single step.

Sequence Diagram for Creating a Basic Promotion
API Reference
Next Steps
- Add conditional rewards to your promotion: ➡️ Configuring Promotion Tiers
Updated 2 days ago