The distribution manager automates communication with your customers. It helps you send messages or incentives automatically when specific events occur. Distributions can send messages directly to customers or transfer data to external tools such as Braze, Mailchimp, or webhook endpoints.Documentation Index
Fetch the complete documentation index at: https://docs.voucherify.io/llms.txt
Use this file to discover all available pages before exploring further.
When to use distributions
Use distributions when you want Voucherify to automatically send a message or incentive after a specific event. Common use cases include:- Sending a welcome code when a customer enters a segment.
- Notifying customers when loyalty points are added.
- Sending reward details after a reward is redeemed.
- Delivering a promotion code after it is published to a customer.
- Sending event data to another system with webhooks.
Key concepts
Distributions are built from four main elements.Message
Message
A message is the data Voucherify pushes to the end customer or another application.
Trigger
Trigger
A trigger defines when Voucherify starts a distribution.For example, a distribution can start when:
- Customer enters a segment
- Voucher is redeemed
- Loyalty points are added
Audience
Audience
The audience defines who receives the message.Depending on the selected trigger, the audience can include:
- Single customer
- Customers in a segment
- Customers affected by an event
Action
Action
The action defines what customers receive after the distribution is triggered.Depending on the selected action, the message can include:
- Voucher code
- Promotion details
- Redeemed reward information
- Plain message
Channel
Channel
The channel defines how Voucherify delivers the message or transfers data.Common channels include:
- Email: Sends messages directly from Voucherify.
- SMS: Sends text messages through configured SMS providers.
- Webhook: Sends event data to external systems.
- External integrations: Transfer Voucherify data to tools like Braze or Mailchimp.
Distribution types
Voucherify supports manual and automatic distributions.Manual distribution
Use manual distributions when you want to send a one-time message or incentive without waiting for an event trigger. Messages are delivered with a 10-minute delay. This delay gives you time to stop or edit the distribution before messages are sent. Manual distributions can target:- Single customer
- Customer segment
Automatic distribution
Use automatic distributions when you want Voucherify to react automatically to customer activity or system events. For example, automatic distributions can start when:- Customer enters a segment
- Voucher is redeemed
- Loyalty points are added
Distribution triggers
Triggers define when Voucherify starts a distribution. In the distribution builder, you choose one trigger to start the workflow.Segment related activity
Segment related activity
Cart related activity
Cart related activity
Voucher related activity
Voucher related activity
Customer rewards
Customer rewards
Use these triggers to react to loyalty reward activity:
- Reward redeemed: Starts the distribution when a customer redeems a loyalty or referral reward.
Manual message
Manual message
Use this trigger when you want to send a one-time message without an event trigger:
- Manual message: Sends a distribution manually after confirmation.
Publishing codes
Publishing codes
Use this trigger to react to code assignment events:
- Successfully published: Starts the distribution when a code is published to a customer.
Custom events
Custom events
Use this trigger to react to custom events tracked in Voucherify:
- Custom event: Starts the distribution when your system tracks a custom event in Voucherify.
Loyalty tier related activity
Loyalty tier related activity
Referral related activity
Referral related activity
Distribution actions
Use actions to define what customers receive after a distribution is triggered. Common actions include:- Send and publish unique codes from campaign: Voucherify selects a code from a campaign, publishes it to the customer, and sends it.
- Notify customers about promotion: Sends details of an in-cart promotion tier.
- Send plain message to customers: Sends a message without a voucher or reward.
- Customer will get a message with amount of received credits: Sends a message when a customer receives new credits on a gift card. The message includes the credited amount.
- Customer will get a message with amount of received points: Sends a message when a customer receives new loyalty points. The message shows how many points were added.
- Customer will get a message with reward details: Sends a message after a customer redeems a reward in a loyalty campaign. The message includes reward information.
- Customer will get a promotion code from [campaign]: Sends a message when a code is successfully published to a customer from the selected campaign.
- Customer will get a message: Sends a configured message related to the selected action.
Channels
Use channels to decide how customers receive messages or how Voucherify transfers data to external systems. Voucherify offers:- Built-in channels like email, SMS, webhooks.
- Integrated tools like Braze, Mailchimp, Klaviyo, Intercom, and more.
Some integrations do not send messages directly to customers. Voucherify transfers the code or event data to the external platform, where the final message is sent.
Limits and anti-spam policy
To send messages through Voucherify, your account must follow the Voucherify anti-spam policy:- Trial accounts are limited to 10 total messages before verification.
- Verified trial accounts can send up to 10 messages per day and 100 per month.
- Email sending requires Brand Details in Project settings.
Create distribution
Read the Create distribution article to learn how to set up a distribution.Managing distributions
Go to Engagement > Distributions and click on a given distribution to monitor its activity and delivery status. Each distribution includes:- Dashboard summary with delivery statistics
- Performance metrics for sent messages
- Issue reporting for failed deliveries
- Activity log with distribution events
Related features
Learn more about features related to distributions.Code publication
Code publication
Learn how Voucherify assigns unique codes to customer profiles and why publications are required for loyalty and referral campaigns.
Webhooks
Webhooks
Use webhook channels to send Voucherify events and incentive data to external systems in real time.
Customer segments
Customer segments
Build customer segments based on customer attributes, metadata, and tracked behavior.

