Overview
The Referral Factory Trigger node is designed to interact with the Referral Factory API, allowing users to set up triggers based on specific events related to user engagement in campaigns. This node can be particularly beneficial for marketing automation workflows where actions need to be taken when users join campaigns, are qualified, or when rewards are issued. For example, a business could use this node to automatically send welcome emails to new users who join a campaign or notify team members when a reward is issued.
Properties
| Name | Meaning |
|---|---|
| Trigger On | Specifies the event that will trigger the node. Options include: - When a New User Joins Your Campaign - When a User Is Qualified - When a Reward Issued via N8n |
| With Source Names or IDs | Allows selection of user sources that should trigger the event. Users can choose from a list or specify IDs using an expression. Only applicable for "user.join". |
| Choose Your Campaign Name or ID | Selects the campaign created in Referral Factory. Users can choose from a list or specify an ID using an expression. Applicable for "user.join" and "user.qualified". |
| Choose Your Reward Name or ID | Selects the reward created in Referral Factory. Users can choose from a list or specify an ID using an expression. Only applicable for "reward_issued". |
Output
The output structure of the json field consists of data received from the Referral Factory API when the specified event occurs. The exact structure may vary depending on the event but generally includes details about the user, campaign, or reward associated with the trigger. If the node can output binary data, it would typically represent files or images related to the triggered event.
Dependencies
- An API key credential is required to authenticate requests to the Referral Factory API.
- The node relies on the following external services:
- Referral Factory API for managing campaigns, users, and rewards.
Troubleshooting
Common Issues:
- Users may encounter issues if the API key is invalid or not provided, leading to authentication errors.
- If the selected campaign or reward does not exist, the node may fail to execute properly.
Error Messages:
- "Authentication failed": Ensure that the API key is correct and has the necessary permissions.
- "Campaign not found": Verify that the selected campaign ID exists in the Referral Factory.
- "Reward not found": Check that the specified reward ID is valid and corresponds to an existing reward.