Kakiyo

Interact with the Kakiyo API

Actions19

Overview

This node integrates with the Kakiyo API to manage prospects within campaigns. Specifically, the "Add Single" operation under the "Prospect" resource allows users to add a single prospect to a specified campaign by providing essential details such as the prospect's name and LinkedIn URL. This is useful in scenarios where you want to enrich your marketing or sales campaigns by programmatically adding new leads or contacts one at a time.

Practical examples:

  • Automatically adding a newly identified lead from a CRM or form submission into a Kakiyo campaign.
  • Enriching a campaign with targeted prospects sourced from LinkedIn profiles.
  • Integrating with other workflow automation tools to keep prospect lists up-to-date without manual entry.

Properties

Name Meaning
Campaign ID The unique identifier of the campaign to which the prospect will be added.
Name The full name of the prospect being added.
LinkedIn URL The LinkedIn profile URL of the prospect.
Additional Fields Optional additional custom fields for the prospect; each consists of a field name and value.

Output

The node outputs JSON data representing the response from the Kakiyo API after adding the prospect. This typically includes confirmation details about the newly created prospect record, such as its ID and any metadata returned by the API.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the Kakiyo API via an API key credential configured in n8n.
  • The node expects the base URL of the Kakiyo API to be set in the credentials.
  • Proper permissions on the API key to add prospects to campaigns are necessary.

Troubleshooting

  • Common issues:

    • Missing or invalid Campaign ID: The API call will fail if the campaign does not exist or the ID is incorrect.
    • Invalid LinkedIn URL format: Ensure the URL is correctly formatted and accessible.
    • Insufficient API permissions: The API key must have rights to add prospects.
    • Network or authentication errors: Check API credentials and network connectivity.

  • Error messages:

    • "error": "Campaign not found": Verify the Campaign ID is correct.
    • "error": "Invalid LinkedIn URL": Confirm the URL is valid and properly formatted.
    • Authentication failures: Recheck the API key and credential setup in n8n.

Resolving these usually involves verifying input parameters, ensuring API credentials are valid, and confirming network access.

Links and References

Discussion