SmartLead icon

SmartLead

Comprehensive SmartLead API integration for email marketing automation

Overview

This node integrates with the SmartLead API to manage leads, campaigns, email accounts, analytics, and related resources for email marketing automation. Specifically, the Lead Management - Get Categories operation fetches all lead categories available in the SmartLead system.

This operation is useful when you want to retrieve a list of predefined or custom categories that leads can be assigned to within your campaigns. For example, you might use this to dynamically populate dropdowns in your workflows or to segment leads based on category before performing further actions like sending targeted emails or updating lead information.

Practical examples:

  • Fetching lead categories to display options for categorizing new leads.
  • Using categories to filter leads for reporting or campaign targeting.
  • Automating lead assignment by category in multi-step workflows.

Properties

Name Meaning
Additional Fields Collection of optional parameters:
- Limit Number of results to return (default 100)
- Offset Number of results to skip (default 0)
- Status Campaign status filter with options: Active, Paused, Stopped (default Active)

Note: For the Get Categories operation under Lead Management, the "Additional Fields" property is not explicitly used in the code, but it is defined generally for other operations.

Output

The output JSON contains the data returned from the SmartLead API endpoint /leads/categories. This will typically be an array of lead category objects, each describing a category's properties such as its ID, name, description, or other metadata provided by the API.

The node returns this data as an array of JSON objects, one per category, structured for easy consumption in subsequent workflow steps.

No binary data output is involved in this operation.

Dependencies

  • Requires an API key credential for authenticating with the SmartLead API.
  • The base URL for API requests is https://server.smartlead.ai/api/v1.
  • The node uses HTTP GET method to fetch lead categories.
  • Proper configuration of the API authentication credential in n8n is necessary.

Troubleshooting

  • Invalid JSON errors: Not applicable for this operation since no JSON input parsing is required.
  • Authentication errors: Ensure the API key credential is correctly configured and has permissions to access lead categories.
  • Network or API errors: Check network connectivity and SmartLead service status.
  • Empty results: If no categories are returned, verify that categories exist in the SmartLead account or check if any filters are applied unintentionally.

Links and References

  • SmartLead API Documentation (hypothetical link based on base URL)
  • SmartLead official website and support channels for API usage details and troubleshooting.

This summary focuses solely on the Lead Management > Get Categories operation as requested, extracted from the provided source code and property definitions.

Discussion