Webhooks allow you to send event data from Kirvano to external systems in real time. This means that when certain actions happen in Kirvano (such as a sale, subscription activation, or order status change), Kirvano will send that information automatically to a URL you specify.
With webhook integration, you can automate processes such as:
-
Notifying your system about new sales
-
Syncing purchase data with your internal database
-
Triggering actions in CRMs or other tools
-
Updating subscriptions in third-party platforms
-
Integrating with automation tools such as Zapier, Make, and others
Step-by-Step: How to Configure a Webhook in Kirvano
1. Prepare Your Endpoint URL
Before configuring the webhook in Kirvano, you need a valid endpoint URL on the system where you want to receive events. This endpoint must:
-
Support receiving POST requests
-
Accept JSON data
-
Be publicly accessible (not blocked by firewalls or IP restrictions)
Your endpoint will receive data from Kirvano each time an event occurs.
2. Access Webhook Integration Settings
Log in to your Kirvano account.
In the sidebar menu, go to Integrations.
Select Webhook (or Webhooks) to begin setting up a new webhook integration.
3. Create a New Webhook
In the webhook configuration screen:
Name:
Enter a name that identifies this webhook (for example: “CRM Sync”, “Internal API”, or “Order Tracker”).
Endpoint URL:
Paste the URL of the system that will receive the webhook events.
Events to Send:
Select one or more events you want to be delivered via webhook. Common options include:
-
New sale created
-
Payment confirmed
-
Subscription activated
-
Subscription cancelled
-
Refund issued
-
Chargeback confirmed
-
Customer data updated
Choose all events relevant to your workflow.
4. Optional Security Settings
To increase security between Kirvano and your endpoint, you may configure:
Signature or Token:
A secret key that Kirvano will send along with each webhook request. Your system can verify that the request was legitimately sent by Kirvano based on this secret. Make sure to keep this secret safe.
5. Save the Webhook
After filling in the required fields and choosing which events will trigger webhook calls:
- Click Save or Activate to finish setting up the webhook.
Once saved, Kirvano will start sending webhook requests to your specified endpoint whenever the selected events occur.
How Webhook Data Works
-
Webhook data is sent as JSON in a POST request.
-
Each event payload contains information relevant to the event type, such as sale ID, product details, buyer information, amounts, dates, and more.
-
It’s recommended that your endpoint returns a 200 OK response to confirm receipt.
-
If the endpoint does not respond with a success status, Kirvano may retry delivery based on its retry strategy.
Testing and Debugging Webhooks
To make sure your webhook integration works correctly:
-
Use tools like request debuggers or logs on your endpoint to confirm that JSON data is arriving.
-
Test different events (e.g., make a test purchase) and monitor if your endpoint is receiving the webhook data.
-
Log and handle errors (in case your system is temporarily unavailable).
Use Cases and Benefits
Webhooks help you automate real-time workflows such as:
-
Synchronizing sales data with your accounting system
-
Updating dashboards in real time
-
Triggering email or SMS notifications
-
Updating CRM records when a purchase occurs
-
Automating membership access or CRM tags
Webhooks are ideal for systems that require immediate awareness of changes happening in Kirvano.
If you have any questions or need assistance, please contact our Support team.