Actions24
- Account Actions
- Analytics Actions
- Campaign Actions
- Lead Actions
Overview
This node integrates with the Instantly API to update lead information in a marketing or sales context. It allows users to modify details of an existing lead, such as contact information, company data, interest status, and campaign association. This is useful for keeping lead records current based on new interactions or data enrichment.
Practical examples include:
- Updating a lead’s email or phone number after receiving updated contact info.
- Changing the lead’s interest status to reflect recent engagement (e.g., marking as "Meeting Booked").
- Associating a lead with a specific marketing campaign to track its source or progress.
Properties
| Name | Meaning |
|---|---|
| Lead | The lead to operate on. Can be selected from a searchable list of leads or specified by ID. |
| Update Fields | Collection of fields to update on the lead: |
| Email address of the lead. | |
| - First Name | First name of the lead. |
| - Last Name | Last name of the lead. |
| - Company Name | Company name associated with the lead. |
| - Phone | Phone number of the lead. |
| - Website | Website URL related to the lead. |
| - Personalization | Custom personalization message for the lead. |
| - Interest Status | Lead interest status; options include: Out of Office, Interested, Meeting Booked, Meeting Completed, Closed, Not Interested, Wrong Person, Lost. |
| - Potential Value | Potential monetary value of the lead. |
| - Campaign | Campaign to associate with the lead. Can be selected from a searchable list or specified by ID. |
Output
The node outputs JSON data representing the updated lead object returned from the Instantly API. This typically includes the lead's updated fields reflecting the changes made during the operation.
If the node supports binary data output (not evident from the provided code), it would represent any file or media content related to the lead, but this is not indicated here.
Dependencies
- Requires an API key credential for authenticating with the Instantly API.
- Uses Instantly API endpoints to fetch campaigns, accounts, and leads, and to perform the update operation.
- The node depends on n8n's generic API request helper functions to communicate with the Instantly API.
- No additional external libraries beyond those bundled with n8n are required.
Troubleshooting
- Invalid Lead ID: If the lead ID does not match the expected UUID format, the node will reject the input. Ensure the lead ID is correctly formatted.
- API Authentication Errors: Missing or invalid API credentials will cause authentication failures. Verify that the API key credential is properly configured.
- Empty Update Fields: Attempting to update a lead without specifying any fields may result in no changes or errors. Always provide at least one field to update.
- Network or API Errors: Temporary network issues or API downtime can cause request failures. Retry after some time or check API status.
- Campaign or Lead Not Found: Selecting a campaign or lead that does not exist or has been deleted will cause errors. Use the dropdown search to select valid entries.