Instantly icon

Instantly

Interact with Instantly API

Actions24

Overview

This node integrates with the Instantly API to manage leads, campaigns, accounts, and analytics data. 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 clean up or remove outdated or unwanted leads programmatically as part of an automated workflow.

Practical examples include:

  • Automatically deleting leads that have unsubscribed or bounced.
  • Cleaning up test or duplicate leads after a campaign.
  • Managing lead lifecycle by removing leads after certain conditions are met.

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 ID directly. The lead ID must be a valid UUID string (e.g., 01234567-89ab-cdef-0123-456789abcdef).

The "Lead" property supports two modes:

  • From List: Select a lead from a dropdown list populated dynamically by fetching leads.
  • By ID: Enter the lead's UUID manually.

Output

The node outputs JSON data representing the result of the delete operation. Typically, this will be a confirmation of deletion or an error message if the operation failed.

  • The output JSON structure corresponds to the response from the Instantly API after attempting to delete the specified lead.
  • If the operation fails and "Continue On Fail" is enabled, the output will contain an error object with the error message.
  • No binary data output is involved in this operation.

Dependencies

  • Requires an API key credential for authenticating with the Instantly API.
  • The node uses the Instantly API endpoints under /api/v2/leads to perform operations.
  • Proper configuration of the API credential in n8n is necessary for successful requests.

Troubleshooting

  • Invalid Lead ID: If the lead ID does not match the UUID format, the node will reject the input. Ensure the lead ID is correctly formatted.
  • Lead Not Found: Attempting to delete a non-existent lead will likely return an error from the API. Verify the lead exists before deletion.
  • API Authentication Errors: Missing or invalid API credentials will cause authentication failures. Check that the API key is correctly configured.
  • Network Issues: Connectivity problems may cause request failures. Retry or check network settings.
  • Error Handling: If "Continue On Fail" is disabled, any error will stop the workflow execution. Enable it to handle errors gracefully.

Links and References

Discussion