⚠️ 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 Ads
Start by creating your Lead Ads in Facebook Ads Manager.
Choose the fields you want to collect (e.g., name, email, phone number).
Decide where users go after submitting the form:
Your website, or
Your ViralSweep promotion
👉 Make sure your form includes the data you want to capture in ViralSweep.
Step 2: Connect Lead Ads to ViralSweep
To connect your Lead Ads:
Go to Integrations → Facebook Lead Ads in ViralSweep
Log in to Facebook and accept all permissions
Select your Facebook Page from the dropdown
Choose one or more Lead Forms
Click Connect
Step 3: Test the Connection
Before going live, test to confirm everything is working correctly.
Open the Facebook Lead Ads Testing Tool
Select your Page and Lead Form
Click Delete Lead (this does NOT remove real leads)
Click Preview Form
Fill out and submit the form
Now, check ViralSweep:
Go to your promotion → Entrants tab
Look for your test submission
The source should display as FB Lead Ads
If the lead doesn’t appear:
Return to the testing tool
Scroll to Webhook Subscription
Click Track Status several times to identify errors
Still stuck? Reach out to support—we’re happy to help.
Step 4: You're All Set 🎉
Once your test lead appears in ViralSweep, your integration is live.
All new leads from your Facebook Lead Ads will automatically sync to your campaign.
FAQ
What data does ViralSweep collect from Lead Ads?
We support the following fields:
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 bypass the spam filter automatically. You don’t need to adjust anything.
How does [AUTO_LOGIN_URL] work?
If you send email notifications through ViralSweep:
The email includes a special login link
When clicked, it recognizes the user
The user is taken directly to the post-entry page (no need to re-enter)
Troubleshooting
Leads are not appearing in ViralSweep
This usually means there’s a connection issue.
Try this:
Edit your campaign in ViralSweep
Remove the Facebook Lead Ads integration
Reconnect your Facebook Page and Lead Form
Run the test again (Step 3)
Error: “CRM access has been revoked”
This means ViralSweep doesn’t have proper permissions.
To fix:
Go to Facebook Business Settings
Re-enable access for Social Promotions in Lead Access Manager
I can’t see or select my Facebook Page
This usually happens if you’re not an admin of the page.
Confirm you have admin access
If you do:
Go to Facebook Settings
Disconnect the Social Promotions App
Reconnect it in ViralSweep
Facebook shows more leads than ViralSweep
This can happen if the connection missed some data.
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 supported, but you can still export that data from Facebook.
Need Help?
If you have any questions, click the chat icon in the bottom-right corner to contact our support team. We’re here to help 👍