Instantly icon

Instantly

Interact with Instantly API

Actions15

Overview

This node integrates with the Instantly API to manage leads, campaigns, accounts, and analytics. Specifically for the Lead - Delete operation, it allows users to delete a lead from their Instantly account by specifying the lead's unique identifier. This is useful in scenarios where you want to automate lead management workflows, such as removing outdated or invalid leads from your marketing campaigns.

Practical examples include:

  • Automatically deleting leads that have unsubscribed or bounced.
  • Cleaning up leads after a campaign ends.
  • Integrating with CRM systems to sync lead deletions.

Properties

Name Meaning
Lead The lead to operate on. You can select a lead either from a searchable list of existing leads or specify the lead by its unique ID (UUID format).

The "Lead" property supports two modes:

  • From List: Search and select a lead from the available leads.
  • By ID: Provide the lead's UUID directly (must match the regex pattern for valid UUIDs).

Output

The node outputs JSON data representing the result of the delete operation. Typically, this will be a confirmation response from the Instantly API indicating whether the lead was successfully deleted.

The output structure is an array of JSON objects, each corresponding to an input item processed. If an error occurs and "Continue On Fail" is enabled, the output will contain an object with an error field describing the issue.

No binary data output is involved in this operation.

Dependencies

  • Requires an API key credential for authenticating with the Instantly API.
  • The node uses HTTP requests to Instantly's REST API endpoints.
  • No additional external dependencies beyond the Instantly API and n8n's standard environment are needed.

Troubleshooting

  • Invalid Lead ID Format: If the provided lead ID does not match the UUID format, the node will reject it before making the API call. Ensure the lead ID is a valid UUID.
  • API Errors: Common errors may include "Lead not found" if the specified lead ID does not exist or has already been deleted.
  • Rate Limits: The Instantly API may enforce rate limits; excessive calls might result in temporary blocking.
  • Limitations on Pagination: While not directly relevant to deletion, other operations fetching leads use pagination capped at 1000 pages to prevent infinite loops.
  • Error Handling: If "Continue On Fail" is enabled, errors for individual items will be returned in the output JSON instead of stopping execution.

Links and References

Discussion