Webhooks allow you to connect Learnybox to any external tool or system (CRM, automation tool, business application, etc.). Each time a key event occurs on your platform (sale, registration, new contact), Learnybox automatically sends the corresponding data to a URL of your choice.
This article is intended for users with technical knowledge or those working with a developer. It explains how Learnybox webhooks work, how to configure them, and the best practices to follow.
What is a webhook?
A webhook is a mechanism that allows Learnybox to automatically send data to a URL that you define whenever an event occurs on your platform. Unlike a traditional API where you need to poll the server, Learnybox sends real-time notifications to your system.
The process is simple:
You configure a receiving URL (called an “endpoint”) on your server or third-party tool.
You select the events you want to track.
When an event occurs, Learnybox sends an HTTP POST request containing the associated data.
Technical requirements
To ensure your webhooks work correctly, make sure the following specifications are respected:
HTTP method: POST
Data format: application/json
Expected response: your server must return an HTTP 200 status code
⚠️ Any response other than 200 will be considered a failure. Learnybox will automatically resend the notification according to the retry schedule below.
Retry policy in case of failure
If your server does not respond correctly, Learnybox will attempt delivery up to 5 times with increasing delays:
Failed attempt 1 → retry after 60 seconds
Failed attempt 2 → retry after 5 minutes
Failed attempt 3 → retry after 10 minutes
Failed attempt 4 → retry after 1 hour
Failed attempt 5 → the notification is permanently marked as failed
Make sure your server responds quickly with an HTTP 200 status code to avoid multiple retries and potential deactivation of your webhook notifications.
Data security
The data sent by Learnybox webhooks is encrypted to ensure confidentiality.
Encryption algorithm: AES-256-CBC
Decryption key: your secret key (available in your Learnybox account settings)
⚠️ Never share your secret key. It is required to decrypt the received data and to ensure that requests are genuinely coming from Learnybox.
Best practices
To ensure reliable webhook integrations, follow these recommendations:
Never expose your secret key: do not store it in plain text in public code repositories
Implement logging: record incoming requests to help with debugging
Handle errors properly: plan for error handling to avoid service interruptions
Respond quickly with HTTP 200: process data asynchronously if needed, but always return a 200 status code immediately to confirm receipt
How to test a webhook
Before deploying to production, you can test your webhooks using the following tools:
webhook.site: generates a temporary URL that displays received requests in real time. Ideal for verifying that Learnybox is sending data correctly
ngrok: creates a secure tunnel to your local machine, allowing you to test your endpoint in real conditions
Postman: lets you simulate and inspect HTTP requests to validate decryption and data processing
Start by using webhook.site to confirm that events are triggered correctly, then move to ngrok to test your processing logic.
FAQ
Are webhooks available on all Learnybox plans?
Are webhooks available on all Learnybox plans?
Check your subscription details or contact support to confirm whether this feature is included.
What happens if my server is temporarily unavailable?
What happens if my server is temporarily unavailable?
Learnybox will retry up to 5 times with increasing delays (from 60 seconds to 1 hour). If all attempts fail, the notification is permanently marked as failed.
Can I receive multiple events on the same URL?
Can I receive multiple events on the same URL?
Yes, you can configure a single endpoint to listen to multiple events. Your server must then differentiate between events within the payload.
Where can I find my secret key to decrypt the data?
Where can I find my secret key to decrypt the data?
Your secret key is available in your Learnybox account settings, in the webhook section.
Where can I find the full list of events?
Where can I find the full list of events?
See our dedicated article: All available events for Learnybox webhooks