Actions20
Lead → Create
AI-generatedOverview
The node integrates with the Reachkit API to create a new lead within a specified campaign. It is designed to add potential customer information (leads) into marketing campaigns managed in Reachkit. This operation is useful for automating lead generation workflows, syncing leads from other systems, or capturing user signups and funneling them directly into marketing campaigns.
Practical examples include:
- Automatically adding new newsletter subscribers as leads to a campaign.
- Importing leads collected from a CRM or web form into Reachkit campaigns.
- Managing lead deduplication by specifying how to handle existing leads (fail, skip, or update).
Properties
| Name | Meaning |
|---|---|
| Campaign ID | The unique identifier of the campaign where the lead will be created. |
| The email address of the lead. | |
| Additional Fields | A collection of optional fields to provide more details about the lead: |
| - First Name | The first name of the lead. |
| - Last Name | The last name of the lead. |
| - If Exists | Defines behavior if the lead already exists in the campaign. Options: Fail, Skip, Update. |
| - Variables | Custom key-value pairs representing additional variables associated with the lead. |
Output
The node outputs JSON data representing the response from the Reachkit API after attempting to create the lead. This typically includes details of the created lead such as its ID, status, and any metadata returned by the API.
If the operation fails due to duplication or validation errors, the output will contain error information accordingly.
No binary data output is involved in this operation.
Dependencies
- Requires an API key credential for authenticating with the Reachkit API.
- The node communicates with the Reachkit REST API at
https://reachkit.ai/api/v1. - Proper configuration of the API key credential in n8n is necessary for successful requests.
Troubleshooting
Common Issues:
- Invalid or missing Campaign ID can cause the API to reject the request.
- Providing an improperly formatted email address may result in validation errors.
- Handling of existing leads depends on the "If Exists" property; incorrect choice might cause unexpected failures or duplicates.
- Network connectivity issues or invalid API credentials will prevent successful communication with Reachkit.
Error Messages:
- Lead already exists: Occurs if "If Exists" is set to "Fail" and the lead email is already present. To resolve, consider using "Skip" or "Update".
- Invalid Campaign ID: Verify that the campaign ID is correct and accessible.
- Authentication failed: Check that the API key credential is correctly configured and valid.
Links and References
- Reachkit API Documentation (hypothetical link for reference)
- n8n documentation on Creating Custom Nodes