Kiwify icon

Kiwify

Interagir com a API da Kiwify

Actions19

Overview

This node integrates with the Kiwify API to manage various aspects of an e-commerce or digital product platform. Specifically, the "Deletar Webhook" (Delete Webhook) operation allows users to delete a specific webhook by its ID. This is useful for managing and cleaning up webhook configurations that are no longer needed or valid.

Common scenarios where this node is beneficial include:

  • Removing outdated or unused webhooks to prevent unnecessary event notifications.
  • Automating webhook lifecycle management as part of deployment or maintenance workflows.
  • Ensuring security by deleting webhooks that may have been compromised or are no longer authorized.

Practical example:

  • A user wants to delete a webhook that was set up for monitoring purchase events but is now obsolete. By providing the webhook's ID, this node will call the Kiwify API to remove it, stopping any further event callbacks from that webhook.

Properties

Name Meaning
ID Do Webhook The unique identifier of the webhook to be deleted. This is required to specify which webhook to remove.

Output

The output is a JSON object representing the response from the Kiwify API after attempting to delete the specified webhook. Typically, this will confirm successful deletion or provide error details if the operation failed.

No binary data is output by this operation.

Example output structure (simplified):

{
  "success": true,
  "message": "Webhook deleted successfully"
}

or in case of failure:

{
  "error": "Webhook not found"
}

Dependencies

  • Requires an API key credential for authenticating with the Kiwify API.
  • The node uses OAuth token retrieval internally by exchanging client credentials.
  • Requires configuration of the Kiwify account ID and client credentials in n8n credentials.
  • Internet access to https://public-api.kiwify.com is necessary.

Troubleshooting

  • Invalid or missing webhook ID: Ensure the "ID Do Webhook" property is correctly set to a valid webhook ID. An incorrect ID will result in an error indicating the webhook was not found.
  • Authentication errors: If the API credentials are invalid or expired, the node will fail to authenticate. Verify that the API key and client credentials are correct and have sufficient permissions.
  • API rate limits or downtime: Temporary failures might occur due to API rate limiting or service outages. Retry after some time or check Kiwify's status page.
  • Permission issues: The authenticated user must have permission to delete webhooks. Lack of permission will cause authorization errors.

Common error messages:

  • "Webhook not found": The provided webhook ID does not exist.
  • "Unauthorized" or "Invalid credentials": Authentication failed; check API credentials.
  • "Forbidden": Insufficient permissions to delete the webhook.

Links and References

Discussion