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 perform various operations related to account management, products, sales, affiliates, webhooks, payouts, and participants. Specifically, the "Consultar Afiliado" (Get Affiliate) operation retrieves detailed information about a specific affiliate by their ID.
Common scenarios for this node include:
- Fetching affiliate details to display or process affiliate data in workflows.
- Managing affiliate information such as commissions and status.
- Automating retrieval of sales statistics, product details, or payout information.
- Creating, updating, or deleting webhooks to respond to events in Kiwify.
- Listing entities like affiliates, products, sales, or participants for reporting or synchronization.
Practical example:
- A marketing automation workflow that fetches an affiliate's details when a new sale is recorded, enabling personalized communication or commission calculations.
Properties
| Name | Meaning |
|---|---|
| ID Do Afiliado | The unique identifier of the affiliate to be consulted or edited. Required for this operation. |
(Note: Only the property relevant to the "Consultar Afiliado" operation is listed here.)
Output
The node outputs JSON data representing the response from the Kiwify API for the requested operation. For "Consultar Afiliado," the output JSON contains detailed information about the specified affiliate, such as their profile, status, commission, and other metadata provided by the API.
The output is structured as an array of items, each containing a json field with the affiliate data. There is no binary data output for this operation.
Dependencies
- Requires an API key credential for authenticating with the Kiwify API.
- Needs configuration of the API client ID, client secret, and account ID within the credentials.
- Uses OAuth token retrieval via a POST request to obtain an access token before making API calls.
- All requests are made to the public Kiwify API endpoints with appropriate authorization headers.
Troubleshooting
- Authentication errors: If the node fails to authenticate, verify that the API credentials (client ID, client secret, and account ID) are correctly configured and valid.
- Invalid affiliate ID: Providing a non-existent or malformed affiliate ID will result in an error from the API. Ensure the ID is correct.
- API rate limits or downtime: Temporary failures may occur if the Kiwify API is unavailable or rate limits are exceeded. Retry after some time or check API status.
- Network issues: Connectivity problems can cause request failures. Confirm network access to the Kiwify API endpoint.
- Error messages: The node throws errors with messages returned from the API. Review these messages to identify issues such as missing parameters or invalid values.
To resolve errors, check the input parameters, credentials, and network connectivity. Enable "Continue On Fail" in the node settings to handle errors gracefully in workflows.
Links and References
- Kiwify API Documentation (official API docs for detailed endpoint info)
- n8n documentation on Creating Custom Nodes