Webhooks

Webhooks enable you to receive near real-time notifications (within seconds to minutes) when specific events occur on your 360Learning platform. Instead of continuously polling our API for updates, you can configure webhooks to have event data pushed directly to a URL you specify.

To receive webhook events, you must create a subscription for the desired event type and designate an endpoint (URL) where the events will be sent.

Webhooks basics

Here’s how webhooks work:

1. Event occurs: An action occurs on our platform (e.g., a new user is created).
2. Webhook triggered: Our system detects the event and prepares a webhook payload with relevant event data.
3. Payload sent: The webhook payload is sent as an HTTP POST request to your configured endpoint URL in near real-time.
4. Your system receives: Your server receives the HTTP POST request and can then process the event data.

Guide sections

This guide is organized into the following sections:

• Subscriptions: Learn how to create and manage webhook subscriptions, including limits.
• Event payload and headers: Understand the structure of webhook event data and important HTTP headers.
• Webhook security and signature verification: Critical steps for verifying the authenticity and integrity of webhook events.
• Retry logic: Information on how retries work.
• Testing webhooks: Methods and tools for testing your webhook integration.
• Webhooks processing best practices for robust webhook processing.