Kakiyo

Interact with the Kakiyo API

Actions19

Overview

The node interacts with the Kakiyo API to manage campaigns and related entities. Specifically, the Campaign - Update operation allows users to modify an existing campaign's details such as its name, qualification thresholds, and custom variables.

This operation is useful when you need to adjust campaign parameters after creation without recreating the entire campaign. For example, you might want to update the campaign’s name to reflect a new marketing focus or change qualification thresholds based on performance data.

Practical examples:

  • Renaming a campaign to align with a new product launch.
  • Adjusting automatic and verification qualification thresholds to refine prospect filtering.
  • Updating campaign-specific variables that influence campaign behavior or messaging dynamically.

Properties

Name Meaning
Campaign ID The unique identifier of the campaign to update (required).
Name New name for the campaign (optional).
Qualification Automatic New automatic qualification threshold, a number between 0 and 100 (optional).
Qualification Verification New verification qualification threshold, a number between 0 and 100 (optional).
Variables A collection of key-value pairs representing custom variables to update in the campaign.

Output

The output JSON contains the updated campaign object returned by the Kakiyo API after the update operation. This typically includes the campaign’s current state with all updated fields such as:

  • id: Campaign identifier
  • name: Updated campaign name
  • qualificationAutomatic: Updated automatic qualification threshold
  • qualificationVerification: Updated verification qualification threshold
  • variables: Object containing the updated variables as key-value pairs

No binary data is output by this node.

Dependencies

  • Requires an active connection to the Kakiyo API via an API key credential configured in n8n.
  • The base URL for the API is taken from the credential configuration.
  • The node uses standard HTTP methods (PUT) to update campaign data.

Troubleshooting

  • Missing or invalid Campaign ID: The update operation requires a valid campaign ID. Ensure the ID is correct and corresponds to an existing campaign.
  • Invalid qualification thresholds: Qualification values must be numbers between 0 and 100. Values outside this range may cause errors.
  • API authentication errors: If the API key or credentials are incorrect or expired, requests will fail. Verify the credential setup in n8n.
  • Empty update payload: If no fields are provided to update (e.g., no name, thresholds, or variables), the API may reject the request or perform no changes.
  • Network or API downtime: Temporary connectivity issues or Kakiyo API outages can cause request failures.

To resolve errors, check input parameters, validate credentials, and review API response messages for specific error details.

Links and References

Discussion