Kiwify icon

Kiwify

Interagir com a API da Kiwify

Actions19

Overview

This node integrates with the Kiwify API to manage and retrieve information about webhooks, products, sales, affiliates, payouts, participants, and account details. Specifically, the "Listar Webhooks" operation fetches a paginated list of all webhooks configured in the Kiwify account, optionally filtered by product ID or a search term.

Common scenarios for using this node include:

  • Automating the retrieval of webhook configurations for monitoring or auditing.
  • Filtering webhooks related to specific products to manage integrations.
  • Integrating Kiwify webhook data into workflows for further processing or notifications.

Practical example:

  • A user wants to get all webhooks related to a particular product to verify which events trigger them. They can use this node with the "Listar Webhooks" operation, specify the product ID filter, and retrieve the relevant webhooks.

Properties

Name Meaning
Tamanho Da Página Number of webhooks to return per page (pagination size).
Número Da Página Page number to retrieve (pagination index).
ID Do Produto Optional filter to return only webhooks associated with a specific product ID.
Buscar Optional search term to filter webhooks by name or other searchable fields.

Output

The node outputs an array of JSON objects representing the webhooks retrieved from the Kiwify API. Each object contains detailed information about a webhook, such as its ID, name, URL, associated products, triggers, and optional token.

No binary data is output by this operation.

Example output structure (simplified):

[
  {
    "id": "webhook_id",
    "name": "Webhook Name",
    "url": "https://example.com/webhook",
    "products": ["product_id1", "product_id2"],
    "triggers": ["compra_aprovada", "subscription_renewed"],
    "token": "optional_token"
  },
  ...
]

Dependencies

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

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.
  • Pagination issues: Requesting a page number beyond the available pages may return empty results. Adjust the page number accordingly.
  • Filtering returns no results: Ensure the product ID or search term used for filtering matches existing webhooks.
  • API rate limits: Excessive requests might be throttled by the Kiwify API; implement retry logic or reduce request frequency.
  • Network errors: Check network connectivity and firewall settings to allow outbound HTTPS requests to the Kiwify API endpoint.

Links and References

Discussion