Salesforce Integration
Connect your Salesforce org to LeadFuel for automatic contact matching, campaign attribution, activity logging, and lead creation.
Before You Start
- A LeadFuel account with Pro or Enterprise plan
- A Salesforce account with admin or API access
- A Salesforce Connected App configured for OAuth 2.0 (your Salesforce admin can set this up)
Navigate to Integration Settings
Log in to your LeadFuel dashboard and go to Settings → Integrations. You'll see sections for CRM and enrichment providers.
Scroll to the Salesforce section. You'll see fields for: - Client ID - Client Secret - Instance URL
These come from your Salesforce Connected App configuration.
Create a Salesforce Connected App (If Needed)
If your Salesforce admin hasn't already created a Connected App for LeadFuel, here's what they need to do:
- 1In Salesforce, go to Setup → App Manager → New Connected App
- 2Fill in the basic info:
- 3 - Connected App Name:
LeadFuel - 4 - API Name:
LeadFuel - 5 - Contact Email: your admin's email
- 6Under API (Enable OAuth Settings):
- 7 - Check 'Enable OAuth Settings'
- 8 - Callback URL:
https://lead-fuel.com/api/auth/callback/salesforce - 9 - Selected OAuth Scopes:
Full access (full),Perform requests at any time (refresh_token, offline_access) - 10Save the Connected App
- 11Wait 2–10 minutes for Salesforce to activate it
- 12Go back to the Connected App and copy the Consumer Key (this is the Client ID) and Consumer Secret
Your Instance URL is the base URL of your Salesforce org — for example, https://yourcompany.my.salesforce.com.
If you're not a Salesforce admin, send these instructions to whoever manages your org. They'll need to create the Connected App and share the Client ID and Client Secret with you.
Enter Your Salesforce Credentials
Back in LeadFuel Settings → Integrations → Salesforce:
- 1Client ID: Paste the Consumer Key from your Connected App
- 2Client Secret: Paste the Consumer Secret
- 3Instance URL: Enter your Salesforce instance URL (e.g.,
https://yourcompany.my.salesforce.com) - 4Click Save
LeadFuel stores these credentials securely per-tenant — they're never shared with other accounts.
Test the Connection
After saving, click the Test Connection button. LeadFuel will attempt to authenticate with Salesforce using your credentials.
If successful, you'll see a green confirmation message. If it fails, double-check:
- The Client ID and Client Secret are correct (no extra spaces)
- The Instance URL includes https:// and your org's subdomain
- The Connected App is active in Salesforce (can take up to 10 minutes after creation)
- Your Salesforce user has API access enabled
Link Events to Salesforce Campaigns
For campaign attribution to work, you need to link your LeadFuel events to Salesforce campaigns.
- 1Go to Dashboard → Events
- 2Click on an event (or create a new one)
- 3In the event settings, you'll see a Salesforce Campaign dropdown
- 4Select the campaign you want leads from this event attributed to
When a lead is captured at this event, LeadFuel will automatically: - Search for an existing Contact matching the lead's name and company - Search for an existing Account matching the company - Create the Contact if it doesn't exist - Add the Contact as a Campaign Member to the linked Salesforce campaign - Log an Activity on the Contact with conversation details and AI-generated notes
Create the Salesforce campaign before the event so it's ready in the dropdown. Name it consistently (e.g., '2026 AWS re:Invent') so it's easy to find.
How Matching Works
When LeadFuel processes a lead, the Salesforce integration runs this matching logic:
Contact matching:
1. Search by email (if available) — exact match
2. Search by name + company — fuzzy match
3. If no match found, a new Contact is created
Account matching:
1. Search by company name — fuzzy match
2. If found, the Contact is linked to the existing Account
3. If not found, LeadFuel notes the company but doesn't create a new Account (to avoid duplicates)
Campaign Members:
Activity Logging:
Verify It's Working
After processing your first few leads, verify the integration is working:
- 1Open a processed lead in your LeadFuel dashboard
- 2Look for the Salesforce section — you should see:
- 3 -
sf_contact_id— the matched or created Contact ID - 4 -
sf_account_id— the matched Account ID - 5 - Campaign membership status
- 6Open the Contact in Salesforce and verify:
- 7 - The Activity was logged with conversation notes
- 8 - Campaign membership shows the correct campaign
If any of these are missing, check the lead's audit trail (Lead Detail → Audit Trail) for error messages.