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

Sequence Diagram for Creating a Basic Promotion

API Reference

Next Steps