Kakiyo

Overview

This node interacts with the Kakiyo API to manage prospects within campaigns. Specifically, the "Add Batch" operation under the "Prospect" resource allows users to add multiple prospects at once to a specified campaign. This is useful for bulk importing or updating prospect lists efficiently without needing to add each prospect individually.

Common scenarios include:

• Importing a list of LinkedIn profiles as prospects into a marketing or sales campaign.
• Bulk updating prospects with additional custom fields.
• Automating the onboarding of large prospect datasets into Kakiyo campaigns.

Example: You have a CSV export of potential leads with their names and LinkedIn URLs. Using this node's "Add Batch" operation, you can upload all these leads in one request to your campaign, optionally including extra metadata fields per prospect.

Properties

The "Prospects" property supports multiple entries, allowing you to specify many prospects in one batch.

Output

The node outputs a JSON array where each element corresponds to the response from the Kakiyo API for the batch addition request. The structure typically contains details about the added prospects or confirmation of successful addition.

No binary data output is involved in this operation.

Dependencies

• Requires an active connection to the Kakiyo API.
• Needs an API authentication token configured in n8n credentials (referred generically as "an API key credential").
• The base URL for the Kakiyo API must be set in the credential configuration.

Troubleshooting

• Missing or invalid Campaign ID: Ensure the Campaign ID is correctly provided and exists in Kakiyo; otherwise, the API will reject the request.
• Malformed prospect data: Each prospect must have a valid name and LinkedIn URL. Additional fields should be properly formatted as key-value pairs.
• API authentication errors: Verify that the API key credential is valid and has sufficient permissions.
• Batch size limits: If the batch is too large, the API might reject the request or timeout. Try splitting the batch into smaller chunks.
• Network issues: Check connectivity to the Kakiyo API endpoint.

Error messages returned by the node will generally reflect the underlying API error message, such as validation failures or authentication errors. Review the error details to adjust input parameters accordingly.

Links and References

• Kakiyo API Documentation (Assumed URL, replace with actual if known)
• n8n Documentation on Creating Custom Nodes
• Best practices for Handling Batch Requests