Smartlead icon

Smartlead

Interact with the Smartlead.ai API

Overview

This node interacts with the Smartlead.ai API to manage email accounts and related campaign data. Specifically, for the Email Account resource with the Get Many operation, it fetches multiple email accounts from the Smartlead system. This is useful when you want to retrieve a list of all email accounts associated with your Smartlead environment, possibly for monitoring, reporting, or further automation.

Common scenarios include:

  • Listing all email accounts to display in a dashboard.
  • Fetching email accounts with pagination to process them in batches.
  • Filtering email accounts based on certain criteria like sequence number or status (if applicable).

Example use case:

  • You want to get the first 50 email accounts starting from the beginning to sync them with another system or analyze their statuses.

Properties

Name Meaning
Additional Options Collection of optional parameters to refine the query:
- Limit Max number of results to return (minimum 1, default 50).
- Offset Starting index for pagination (default 0).
- Email Sequence Number Filter by sequence number (e.g., 1, 2).
- Email Status Filter by email status; options are: Opened, Clicked, Replied (default "opened").

These properties allow controlling how many email accounts to fetch, where to start fetching from, and filtering by sequence number or status.

Output

The output is a JSON array where each item represents an email account object as returned by the Smartlead API. The structure typically includes details about each email account such as its ID, configuration, status, and other metadata managed by Smartlead.

No binary data is output by this operation.

Dependencies

  • Requires an active connection to the Smartlead.ai API.
  • Requires an API authentication token configured in n8n credentials (referred generically as "an API key credential").
  • The base URL used for requests is https://server.smartlead.ai/api/v1.

Troubleshooting

  • Common issues:

    • Authentication errors if the API key credential is missing or invalid.
    • Pagination parameters (limit and offset) set incorrectly may result in empty or incomplete results.
    • Network connectivity issues preventing access to the Smartlead API endpoint.
  • Error messages:

    • Unauthorized or 401 errors indicate problems with API credentials.
    • 400 Bad Request errors may occur if parameters are malformed or out of range.
    • Timeout or network errors suggest connectivity problems.
  • Resolutions:

    • Verify that the API key credential is correctly set up in n8n.
    • Adjust pagination parameters to valid values.
    • Check network access and proxy settings if applicable.

Links and References

Discussion