Contact support and we will keep this article attached to your request.
How new referrers are created or synced into 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.

Trigger timing
Destination record/object
- Contact
- Lead
- Person
- Customer
- Another supported CRM object
Required fields and mapping
Duplicate handling
One-time/ongoing behavior
Testing
- Add the Referral Factory node.
- Select When a New User Joins Your Campaign.
- Under Credential, connect your Referral Factory account using your API Key.
- Select the correct source or sources.
- Select the campaign you want to use.
- Click Test this trigger.
- Add a new test Referrer to the selected Referral Factory campaign.
- Confirm that the new user's data appears in the n8n trigger output.
- Add your CRM node and map the Referral Factory fields to the correct CRM fields.
- Run the CRM step and confirm that the correct record is created.
- Test with a Referrer who already exists in your CRM to confirm that your duplicate-handling logic works correctly.
- Once the complete workflow works as expected, activate it.
