Skip to main content

Integration with Viral Loops

Sarunas avatar
Written by Sarunas
Updated over 3 weeks ago

Viral Loops is a referral marketing platform that helps ecommerce businesses launch viral campaigns – including referral programs, waitlists, and giveaways.

With the integration to Omnisend, you can sync participants, reward milestones, and referral conversion events directly into your marketing workflows. This enables personalized follow-ups, loyalty incentives, and automated messaging based on real-time referral data.


Key Benefits

  • Automatically create contacts in Omnisend when new participants join your Viral Loops campaign.

  • Track and sync conversion, milestone, and reward events to trigger automation in Omnisend.

  • Power loyalty and referral-based segmentation and campaigns.

  • Enable milestone-based reward flows without manual export or syncing.

  • Build personalized experiences based on the user referral journey.

Setup Process

Step 1. Go to the Omnisend App Market and search for Viral Loops. Click the 'Connect now' button.

Step 2. Wait a moment for the page to load, then see if you want all the available events to be passed to Omnisend and click continue.

Step 3. Click on Grant Access below Viral Loops.


You will see this page, where you need to enter your connection name. It can be anything or left default; it will not affect the integration. For the API token, refer to the next step.

Step 4. Go to your Viral Loops campaigns dashboard: https://app.viral-loops.com/#/campaigns. Then, click Edit.


Select the Installation step, copy the Secret API token, and paste it into the field from the previous step in this guide.

Then, click Continue

Step 5. You will see his window pop up with a webhook URL, copy it.

Back in the Viral Loops campaign page - go back to Integrations step, find Webhook and click on it.


For each event that you have enabled in Step 2 of this guide, you should paste the Webhook URL you have copied here.

Note: You also need to enable each Webhook Endpoint.

Tip: You can leave this page open and click on Send test Event, after installation is complete, to see if custom events are created for a test contact.


After this is done, click Got it.


Then, click Continue.


Finally, click Let's go!

Step 6. Under Installed scenarios, click Start.

Confirm if all scenarios are enabled, you can disable them one by one through toggles or all together by clicking Pause, then click on Confirm.

You're set. You can now see if existing contacts from the campaign are synced and test events from Step 4.

What Data is Passed

Contact Fields Synced:

  • Email

  • First name

  • Last name

  • Custom properties related to referrals and shares

    • vl_created

    • vl_excluded

    • vl_unique_link

    • vl_referral_code

    • vl_shares_total

    • vl_shares_email

    • vl_shares_reddit

    • vl_shares_twitter

    • vl_shares_linkedin

    • vl_shares_facebook

    • vl_shares_whatsapp

    • vl_referrals_total

    • vl_referrals_copy

    • vl_referrals_reddit

    • vl_referrals_twitter

    • vl_referrals_facebook

    • vl_referrals_linkedin

    • vl_referrals_whatsapp

    • vl_referrer_referral_code

Supported Events

Event Type

Trigger Description

New Participant

Creates a new contact in Omnisend with a New participant event

Conversion Event

Triggered when a referred lead converts

Milestone Event

Triggered when a participant reaches a reward tier

Reward Redeemed Event

Triggered when a participant claims a reward

Use in Automations

You can use Viral Loops events to personalize and automate communications in Omnisend:

  • Welcome New Referrals: Enroll new participants in a dedicated welcome automation.

  • Celebrate Milestones: Send congratulatory messages or discount codes when a milestone is hit.

  • Reward Redemption Follow-up: Trigger emails when users redeem rewards.

  • Conversion Notifications: Notify participants when their referral results in a conversion.

  • Campaign Ending Reminder: Use Viral Loops data to segment and remind participants to hit one more milestone.

Additional Notes

  • Event Frequency: Events are synced in real-time from Viral Loops to Omnisend.

  • Contacts are synced once, when enabling the integration; further contacts will be synced through the New Participant event.

  • Campaign Types: Works with templates like Leaderboard Giveaway, Refer-a-Friend, and Waiting Lists.

  • Sync Behavior: Duplicate contacts will be updated, not recreated.


If you didn't find the answer to your question, reach out to our Support Team through the in-app chat or at [email protected] — our team is available 24/7.

Did this answer your question?