Actions24
- Account Actions
- Analytics Actions
- Campaign Actions
- Lead Actions
Overview
This node integrates with the Instantly API to create new leads in a marketing or sales context. It is designed to add potential customer contacts ("leads") into the Instantly system, which can then be used for outreach campaigns, follow-ups, or CRM enrichment.
Common scenarios where this node is beneficial include:
- Automatically adding new leads collected from web forms or other sources into Instantly.
- Enriching lead data by associating them with specific marketing campaigns.
- Streamlining lead management workflows by integrating Instantly lead creation into broader automation pipelines.
For example, after capturing a visitor's email and name on a website, this node can create a lead record in Instantly, optionally linking it to a campaign for targeted outreach.
Properties
| Name | Meaning |
|---|---|
| The email address of the lead (required). | |
| First Name | First name of the lead. |
| Last Name | Last name of the lead. |
| Company Name | Company name associated with the lead. |
| Additional Fields | Optional extra fields to provide more details about the lead: |
| - Phone | Phone number of the lead. |
| - Website | Website URL related to the lead. |
| - Personalization | A personalized message or note for the lead. |
| - Campaign | The marketing campaign to associate the lead with. Can be selected from a list or specified by ID. |
Output
The node outputs an array of JSON objects representing the created lead(s). Each output item corresponds to one input item processed and contains the lead data returned by the Instantly API after creation.
The json output field includes all relevant information about the newly created lead, such as its unique identifier, email, names, company, and any additional fields set during creation.
This node does not output binary data.
Dependencies
- Requires an API key credential for authenticating with the Instantly API.
- Needs network access to Instantly's REST API endpoints.
- The node uses internal helper functions to make HTTP requests to Instantly's
/api/v2/leadsendpoint. - For selecting campaigns, it fetches available campaigns via Instantly API (
/api/v2/campaigns). - Proper configuration of the API credential within n8n is necessary for successful operation.
Troubleshooting
Common issues:
- Missing or invalid API credentials will cause authentication failures.
- Providing an invalid campaign ID (wrong format) will result in validation errors.
- Required fields like Email must be provided; otherwise, the API will reject the request.
- Network connectivity problems can prevent communication with the Instantly API.
Error messages:
- Errors returned from the Instantly API are surfaced as node execution errors.
- If the node is configured to continue on failure, error details are included in the output JSON under an
errorproperty. - Validation errors for campaign IDs specify that the ID must match a UUID format.
Resolutions:
- Verify API credentials and permissions.
- Ensure required fields are filled correctly.
- Use the campaign selector dropdown to avoid invalid campaign IDs.
- Check network connectivity and proxy settings if applicable.