If you run more than one brand under a single Optimove account, you can now route Minigames event notifications to a different endpoint for each brand. Game events such as campaign completions and prize winners can be sent to brand-specific backend systems, so each brand receives only the notifications that belong to it.
Your Application Programming Interface (API) key stays the same across all brands. Only the webhook URL and the subscribed events can differ from one brand to the next.
When to use this
Per-brand webhooks are useful if you:
- Operate multiple brands under one Optimove Minigames account (for example, two regional brands)
- Maintain brand-specific backend systems that need to receive Optimove Minigames event notifications separately
- Currently use the account-level default webhook but want per-brand routing instead
How to set up a webhook for a specific brand
Step 1: Confirm your brands are set up
In Optimove Minigames, an account can hold multiple brands, and each brand can have its own campaigns and its own webhook configuration. If you need to add a new brand and reach an account limit (for example, "maximum brand number reached"), reach out to your Customer Success Manager to have the allowed brand count raised for your account.
Step 2: Open Webhook settings
- Go to API Central, then the Webhooks tab
- Under Brand webhook settings, use the Settings for dropdown to select the brand you want to configure
- The dropdown offers Account default (applies to every brand without its own webhook) and an entry for each individual brand (a brand-specific override)
Step 3: Configure the brand-specific webhook
With the brand selected in the dropdown:
- Enter the webhook URL for that brand's endpoint
- Optionally enable an authorization token
- Select which events should trigger the webhook for that brand
- Click Save
Repeat for each brand that needs its own configuration. Any brand without a custom configuration continues to use the Account default.
How the settings behave
| Setting | Scope |
|---|---|
| API key | Shared across all brands (unchanged) |
| Webhook URL | Per brand, or falls back to the account default |
| Event subscriptions | Per brand, or falls back to the account default |
| Authorization token | Per brand |
Note: This feature is already available, with no additional setup. The account-level default webhook continues to work as a fallback for any brand that does not have a custom webhook configured.
For developers
This guide covers how to configure per-brand routing in the Optimove Minigames interface. For the technical side, such as setting up your endpoint, available webhook events, and their data payloads, see API & Webhooks: An Overview on the Optimove Developer Hub.