Kakiyo

Interact with the Kakiyo API
Join our community

Actions19

Overview

This node interacts with the Kakiyo API to manage marketing campaigns and related entities such as agents, products, prompts, and prospects. Specifically, for the Campaign - Create operation, it allows users to create a new campaign by specifying essential details like the campaign name, associated product, prompt, and agent IDs, along with qualification thresholds and custom variables.

Common scenarios where this node is beneficial include automating campaign creation workflows in marketing automation platforms, integrating campaign setup into CRM systems, or dynamically generating campaigns based on external triggers.

For example, a marketing team could use this node to automatically create a new outreach campaign whenever a new product is launched, linking the campaign to predefined prompts and agents, and setting qualification criteria to filter leads effectively.

Properties

Name Meaning
Name The name of the campaign to be created.
Product ID The identifier of the product associated with this campaign.
Prompt ID The identifier of the prompt used in this campaign (e.g., message template).
Agent ID The identifier of the agent responsible for this campaign.
Qualification Automatic Numeric threshold (0-100) for automatic qualification of prospects within the campaign.
Qualification Verification Numeric threshold (0-100) for verification qualification of prospects within the campaign.
Variables A collection of key-value pairs representing custom variables to be included in the campaign.

Output

The node outputs JSON data representing the newly created campaign as returned by the Kakiyo API. This typically includes all campaign details such as its ID, name, linked product, prompt, agent, qualification thresholds, and any variables set.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the Kakiyo API.
  • Needs an API authentication token configured in n8n credentials to authorize requests.
  • The base URL for the Kakiyo API must be set in the credential configuration.

Troubleshooting

  • Missing Required Fields: If required properties like Name, Product ID, Prompt ID, or Agent ID are not provided, the API will likely return an error. Ensure all mandatory fields are filled.
  • Invalid Qualification Thresholds: Qualification values should be between 0 and 100. Values outside this range may cause validation errors.
  • API Authentication Errors: If the API key or token is invalid or missing, the request will fail with authentication errors. Verify that the credential is correctly set up.
  • Network Issues: Connectivity problems to the Kakiyo API endpoint can cause timeouts or failures. Check network access and API availability.
  • Variable Formatting: Variables must be provided as an array of objects with name and value. Incorrect formatting may lead to request rejection.

Links and References

Discussion