⚠️ This feature is available on the Business Plan and higher.
How to Set Up Facebook Lead Ads with ViralSweep
Step 1: Create Your Facebook Lead Ad
Start in Facebook Ads Manager by creating your Lead Ad form.
Choose the fields you want to collect, such as:
Name
Email
Phone number
Then decide what happens after someone submits the form:
Send them to your website, or
Send them to your ViralSweep promotion
Tip: Make sure your form includes all the data you want captured in ViralSweep. Only supported fields will sync (see FAQ below).
Step 2: Connect Your Lead Ads to ViralSweep
In ViralSweep, go to Integrations → Facebook Lead Ads
Log in to Facebook and accept all permissions
Select your Facebook Page
Choose one or more Lead Forms
Click Connect
Once connected, ViralSweep will start listening for new leads from your selected forms.
Step 3: Test the Connection
Before launching, run a quick test to confirm everything is working.
Open the Facebook Lead Ads Testing Tool
Select your Page and Lead Form
Click Delete Lead (this won’t remove real leads)
Click Preview Form
Submit a test entry
Then in ViralSweep:
Go to your promotion → Entrants tab
Look for your test submission
The source should show as FB Lead Ads
If your lead doesn’t appear:
Return to the testing tool
Scroll to Webhook Subscription
Click Track Status a few times to surface errors
Still not working? Reach out to support—we’re happy to help.
Step 4: You’re Live 🎉
Once your test lead appears, your integration is active.
All new leads from your Facebook Lead Ads will automatically sync into your ViralSweep campaign.
Controlling the Post-Entry Experience
After someone submits a Facebook Lead Ad, you can control what happens next using email links or redirects.
Option 1: Use [AUTO_LOGIN_URL] (Recommended)
Include [AUTO_LOGIN_URL] in your ViralSweep confirmation email.
When a user clicks this link:
They are automatically recognized
No need to re-enter their information
They’re taken directly to the post-entry experience (like bonus actions or sharing)
This creates a smoother experience and typically increases engagement.
Option 2: Redirect to Your Campaign Landing Page
If you send users to your ViralSweep landing page instead:
Users will need to re-enter their details
Their entry won’t automatically be recognized
This option is less seamless, but may be useful depending on your campaign flow.
💡 Tip: For best results, combine Facebook Lead Ads with a follow-up email that includes [AUTO_LOGIN_URL].
Learn More
For additional tips and best practices, check out our blog post on running successful campaigns with Facebook Lead Ads.
FAQ
What data does ViralSweep collect from Lead Ads?
We currently support:
Full Name*
First Name
Last Name
Email Address
Phone Number
Zip Code
State
Country
Birth Date (MM/DD/YYYY)
* If you use Full Name, it will be stored entirely in the First Name field. The Last Name field will remain blank.
Does the spam filter affect Lead Ads?
No. Entries from Facebook Lead Ads automatically bypass the spam filter—no extra setup needed.
How does [AUTO_LOGIN_URL] work?
When included in a ViralSweep email:
It acts as a secure, personalized login link
Identifies the user automatically
Logs them in instantly when clicked
Takes them directly to your campaign experience
Troubleshooting
Leads are not appearing in ViralSweep
This is usually caused by a connection issue.
Try the following:
Edit your campaign in ViralSweep
Remove the Facebook Lead Ads integration
Reconnect your Facebook Page and Lead Form
Run the test again
Error: “CRM access has been revoked”
This means ViralSweep no longer has permission to access your leads.
To fix:
Go to Facebook Business Settings
Open Lead Access Manager
Re-enable access for Social Promotions
I can’t see or select my Facebook Page
This typically means you don’t have the required permissions.
Confirm you’re an admin of the page
If you are:
Go to Facebook Settings
Disconnect the Social Promotions app
Reconnect it in ViralSweep
Facebook shows more leads than ViralSweep
This can happen if leads were missed during a connection issue.
To resolve:
Export your leads from Facebook
Email them to [email protected]
Include your ViralSweep promotion name
Our team will import them for you.
Full name is showing in the first name field
This happens when using the Full Name field in your Lead Ad.
To fix:
Update your Lead Ad to use:
First Name
Last Name
Some fields are missing in ViralSweep
We only sync supported fields:
Name (Full, First, Last)
Email
Phone
Zip Code
State
Country
Birth Date
Custom fields are not currently supported, but you can export that data from Facebook.
Need Help?
Click the chat icon in the bottom-right corner to contact our support team—we’re here to help 👍