Kakiyo

Interact with the Kakiyo API

Actions19

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 outreach workflows.

For example, a user might have a CSV export of LinkedIn URLs and names of potential clients and wants to add them all to a campaign in one go, including extra metadata like job title or company.

Properties

Name Meaning
Campaign ID The unique identifier of the campaign to which the batch of prospects will be added.
Prospects A collection of prospect entries to add. Each prospect includes:
   Name The name of the prospect.
   LinkedIn URL The LinkedIn profile URL of the prospect.
   Additional Fields Optional key-value pairs for any extra data fields related to the prospect (e.g., job title, location).

Output

The node outputs a JSON array representing the response from the Kakiyo API after adding the batch of prospects. Each item corresponds to the result of adding a prospect, typically including success confirmation or error details per prospect.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the Kakiyo API via an API authentication token configured in n8n credentials.
  • The base URL for the API must be set in the credential configuration.
  • Proper permissions on the API key to add prospects to campaigns are necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing Campaign ID: Ensure the campaign ID exists and is correctly entered.
    • Malformed prospect data: Each prospect must have a valid name and LinkedIn URL; additional fields should be properly formatted.
    • API authentication errors: Verify that the API key credential is valid and has not expired.
    • Rate limits or API quota exceeded: Large batches may hit API limits; consider splitting into smaller batches.

  • Error messages:

    • "error": "Invalid campaign ID" — Check that the campaign ID is correct and the campaign exists.
    • "error": "Missing required prospect fields" — Confirm that each prospect entry includes mandatory fields like name and URL.
    • Authentication failures — Reconfigure or update the API key credential in n8n.

Handling these errors usually involves verifying input parameters and ensuring API credentials are correctly set up.

Links and References

Discussion