Contact support and we will keep this article attached to your request.
When a new Referral Factory lead is sent to N8N
- Create a new a workflow.
- Click + to add a node and search for Referral Factory.
- Select When a New User Joins Your Campaign.
- Under Credential, click Connect to Referral Factory.
- Enter your Referral Factory API Key to connect your account.
- Under With Source Names or IDs, select the source or sources you want the workflow to monitor.
- Under Choose Your Campaign Name or ID, select the Referral Factory campaign you want to connect.
- Click Test this trigger to confirm that n8n can receive new user data from Referral Factory.
- Add your CRM as the next node in the workflow.
- Configure the CRM node to create or update the appropriate record.

Which record/object is created or updated
- Contact
- Lead
- Person
- Customer
- Deal or Opportunity
- Another supported record type
Required fields and mapping
- Last Name
- Phone Number
- Company
- Campaign information
- Referrer information
- Custom fields collected in your campaign
Duplicate handling
Sync timing
How to verify the record and troubleshoot failures
- Configure the New Referral trigger and connect your Referral Factory account using your API Key.
- Select the campaign you want to test.
- Test the trigger in n8n.
- Create a new test Lead in Referral Factory through the normal referral journey.
- Confirm that the Lead data appears in the Referral Factory trigger output in n8n.
- Add your CRM node and map the required fields.
- Run the CRM step.
- Open your CRM and confirm that the correct record was created or updated and that the mapped fields contain the expected values.
- Test again with an email address that already exists in your CRM to confirm that your duplicate-handling logic works correctly.
- Activate the workflow once both new and existing records behave as expected.
