Instantly icon

Instantly

Interact with Instantly API

Actions15

Overview

This node interacts with the Instantly API to manage leads, campaigns, and accounts. Specifically for the Lead - Get Many operation, it retrieves multiple lead records from the Instantly platform. This is useful when you want to fetch a list of leads for analysis, reporting, or further processing in your workflow.

Common scenarios include:

  • Exporting all leads or a subset based on a limit for CRM synchronization.
  • Fetching recent leads to trigger follow-up actions.
  • Aggregating lead data for marketing analytics.

Example: Retrieve up to 50 leads to update a mailing list or feed into a sales dashboard.

Properties

Name Meaning
Return All Whether to return all lead results or only up to a specified limit.
Limit Maximum number of lead results to return (used only if "Return All" is false).

Output

The node outputs an array of JSON objects representing lead records retrieved from the Instantly API. Each object corresponds to a lead and contains fields such as email, company, first name, last name, LinkedIn URL, and other lead details as provided by the API.

No binary data output is produced by this operation.

Dependencies

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

Troubleshooting

  • Common issues:

    • Authentication errors due to missing or invalid API credentials.
    • Exceeding API rate limits imposed by Instantly.
    • Providing invalid parameter values (e.g., negative limit).

  • Error messages:

    • Errors returned from the Instantly API will be passed through, often indicating HTTP status codes like 401 Unauthorized or 429 Too Many Requests.
    • If "Return All" is false but "Limit" is set below 1, the node may throw a validation error.

  • Resolutions:

    • Ensure API credentials are correctly set and valid.
    • Adjust request frequency to comply with rate limits.
    • Set "Limit" to a positive integer when not returning all results.

Links and References

Discussion