Loading
In this article, we will learn how to configure and use webhooks in systeme.io to optimize your business.
1. What is a Webhook?
Webhooks are a powerful tool for automating data transfer between various applications/platforms, allowing users to receive real-time notifications about specific events. They facilitate the integration of systeme.io with other services.
When a predefined event occurs, such as a new order or the addition of a subscriber, systeme.io automatically sends data to a specific URL. This allows you to integrate your business with other tools, automate tasks, and improve the customer experience. Our webhook service ooffers specialized features, allowing developers to receive real-time notifications.
If you want to learn more about how it works, you can check our documentation.
2. Webhook setup in systeme.io:
To set up a webhook in your systeme.io account, follow these simple steps:
In your systeme.io account, click your profile picture, and then click Settings (1).
Click Webhooks (2), then click Create (3) to start creating a webhook.
Enter a name and a Webhook URL where the data will be sent. Then, enter your webhook's secret key.
The Active toggle switch controls whether the webhook is enabled or disabled.
Note: You must provide the server endpoint URL to receive webhook requests. This requires a secure HTTPS endpoint capable of handling these requests. You must use HTTPS to ensure data security and encryption.
Select the specific events that will trigger the webhook in systeme.io, and click Save (4) to finalize the setup..
Once these steps are completed, your webhook will be active, allowing you to receive real-time updates for the selected events in your systeme.io account.
3. Supported event types for your webhooks:
- Contact created: Triggered when a new contact is created in your systeme.io account.
- Contact tag added: Triggered when a tag is added to an existing contact in your contact list.
- Contact tag removed: Triggered when a tag is removed from an existing contact.
- Opt-In: Triggered when a contact subscribes through an opt-in form.
- New sale: Triggered when a customer makes a purchase (supports both funnels and creator stores).
- Sale canceled: Triggered when a subscription is canceled, or a one-time payment is refunded (supports both funnels and creator stores).
You can then manage your webhooks by viewing logs, deleting them, or modifying them as needed.
4. Viewing webhook logs
To monitor your webhook activity or troubleshoot failed deliveries, you can easily access your detailed webhook logs.
To view the logs, click the three-dots menu (...) next to the webhook you want to check, and select View logs (1).
On the logs page, you will find two detailed sections to help you track your data:
- Message log (2): Displays the time, event type, and message details. You can click the details icon to view more information about each message.
- Delivery log (3): Displays the delivery status, time, and whether the destination server successfully received the webhook.
Tip: You can click the Copy log button in the top right corner of either section to quickly copy the data, which is highly useful when troubleshooting with developers.
5. Webhook delivery and retries
Webhook deliveries are processed in the background. If your recipient server is temporarily unavailable, times out, or returns an error, systeme.io will not drop the webhook immediately. Instead, the system will automatically retry the delivery.
Here is how the automatic retry policy works:
- The first delivery attempt is made shortly after the event occurs.
- If the delivery fails, the system will make up to 12 retry attempts.
- The time between retries increases gradually, with a maximum waiting period of about 24 hours between attempts. This means the system will keep trying to deliver your webhook over the course of several days until it succeeds.
By effectively using webhooks in systeme.io, you can automate processes, boost productivity, and easily integrate with other applications and services.