Actions19
- Atualizar Webhook
- Consultar Afiliado
- Consultar Estatísticas De Vendas
- Consultar Produto
- Consultar Saldo Específico
- Consultar Saque
- Consultar Venda
- Consultar Webhook
- Criar Webhook
- Deletar Webhook
- Editar Afiliado
- Listar Afiliados
- Listar Participantes
- Listar Produtos
- Listar Saques
- Listar Vendas
- Listar Webhooks
- Realizar Saque
- Reembolsar Venda
Overview
The node interacts with the Kiwify API to manage webhooks and other resources related to sales, products, affiliates, payouts, and account details. Specifically, the "Atualizar Webhook" (Update Webhook) operation allows users to update an existing webhook's configuration on their Kiwify account.
This node is beneficial for automating the management of webhooks in Kiwify without manually accessing the Kiwify dashboard. For example, you can programmatically change the URL a webhook points to, modify which product events trigger the webhook, or update its authentication token.
Practical use cases include:
- Updating webhook URLs when migrating services.
- Changing the set of product events that trigger notifications.
- Rotating or setting a new security token for webhook validation.
Properties
| Name | Meaning |
|---|---|
| ID Do Webhook | The unique identifier of the webhook to be updated. |
| Nome Do Webhook | The new name for the webhook. |
| URL Do Webhook | The destination URL where the webhook will send event data. |
| Produtos | The product ID to associate with the webhook, or "all" to apply to all products. |
| Triggers | The list of event types that will trigger the webhook. Options include: |
| - Assinatura Atrasada (subscription_late) | |
| - Assinatura Cancelada (subscription_canceled) | |
| - Assinatura Renovada (subscription_renewed) | |
| - Boleto Gerado (boleto_gerado) | |
| - Carrinho Abandonado (carrinho_abandonado) | |
| - Chargeback (chargeback) | |
| - Compra Aprovada (compra_aprovada) | |
| - Compra Recusada (compra_recusada) | |
| - Compra Reembolsada (compra_reembolsada) | |
| - PIX Gerado (pix_gerado) | |
| Token | Optional custom token for securing the webhook (password type). |
Output
The node outputs JSON data representing the response from the Kiwify API after updating the webhook. This typically includes the updated webhook details such as its ID, name, URL, associated products, triggers, and token if set.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for authenticating with the Kiwify API.
- The node uses OAuth token retrieval internally by exchanging client credentials.
- Requires network access to
https://public-api.kiwify.com. - The user must configure the node with valid Kiwify API credentials including client ID, client secret, and account ID.
Troubleshooting
- Authentication errors: If the node fails to authenticate, verify that the provided API credentials are correct and have sufficient permissions.
- Invalid webhook ID: Errors may occur if the specified webhook ID does not exist or belongs to another account.
- Invalid URL or parameters: Ensure the webhook URL is valid and the selected triggers and products are correctly specified.
- API rate limits: Frequent updates might hit API rate limits; consider adding delays or error handling for rate limit responses.
- Network issues: Confirm that the n8n instance has internet access and can reach the Kiwify API endpoint.
Common error messages usually come directly from the Kiwify API and should be inspected in the node's error output for details.
Links and References
- Kiwify API Documentation (official API docs, for detailed webhook and other resource info)
- n8n Documentation (for general usage of custom nodes and credentials)