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
This node integrates with the Kiwify API to manage webhooks among other operations. Specifically, the "Criar Webhook" (Create Webhook) operation allows users to create new webhooks in their Kiwify account. This is useful for automating workflows that react to events such as sales, subscription changes, or payment notifications by sending HTTP requests to specified URLs when those events occur.
Practical examples include:
- Automatically notifying an external system when a purchase is approved.
- Triggering marketing automation when a subscription is renewed.
- Logging chargebacks or refunds in a CRM system.
Properties
| Name | Meaning |
|---|---|
| Nome Do Webhook | The name identifier for the webhook being created. |
| URL Do Webhook | The destination URL where the webhook payloads will be sent. |
| Produtos | The product ID to which the webhook applies, 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 string for securing the webhook calls. |
Output
The node outputs JSON data representing the response from the Kiwify API after creating the webhook. This typically includes details about the newly created webhook such as its ID, name, URL, associated products, triggers, and token if set.
No binary data output is involved.
Dependencies
- Requires an API key credential for authenticating with the Kiwify API.
- The node uses OAuth token retrieval internally by exchanging client credentials.
- Network access to
https://public-api.kiwify.comis required.
Troubleshooting
- Authentication errors: Ensure the API credentials (client ID, client secret, and account ID) are correctly configured in n8n credentials.
- Invalid webhook URL: The webhook URL must be reachable and accept POST requests; otherwise, webhook delivery will fail.
- Empty or invalid triggers/products: Make sure at least one valid trigger is selected and the product ID is correct or set to
"all". - API rate limits or downtime: If requests fail unexpectedly, check Kiwify API status and consider retry logic.
Common error messages come directly from the Kiwify API and usually indicate issues like invalid parameters, unauthorized access, or resource not found.
Links and References
- Kiwify API Documentation (official API docs)
- Webhook Concepts (general webhook explanation)