Webhooks
Push Skillhabit course, progress, and meetup events to your HTTPS endpoint.
What This Is For
Webhooks let Skillhabit call your system when something happens in the workspace—for example a learner finishes a course, a certificate expires, or a meetup occasion changes. Your endpoint receives a JSON delivery; you update a CRM, HR tool, chat channel, or data warehouse.
Webhooks are outbound only. You do not create or trigger them through the External API REST calls. You configure endpoints in the product, then Skillhabit delivers events when they occur.
In the product: Configure → Connections → Webhooks.
You can have up to five webhooks. The feature must be enabled for your account—contact Skillhabit if it is not available.
Who This Is For
Workspace administrators who create the webhook in Configure, and developers who own the HTTPS receiver.
How It Fits With the External API
| Capability | Direction | Where to start |
|---|---|---|
| REST External API | Your system → Skillhabit | External API / API reference |
| Webhooks | Skillhabit → your HTTPS endpoint | This section · Configure → Webhooks |
Both share the same workspace context. Keys authenticate inbound API calls; custom headers on a webhook (if you set them) help your receiver authenticate outbound deliveries.
What You Can Automate
- CRM updates when a learner completes a course or earns a certificate
- HR reminders when a certificate is about to expire
- Chat / ops alerts when someone is invited, starts learning, or a meetup changes
Categories vs Event Names
In Configure you subscribe by category (for example Progress, Course, Meetup). Each delivery then includes a precise eventType string (for example progress.course.evaluated) in the JSON body and in the Event-Type HTTP header.
| Configure category | What it covers | Notes |
|---|---|---|
| Course | Course content created, updated, info updated, deleted | Content-authoring events |
| Progress | Invites, course / SCORM / program progress, certificates | Includes SCORM and program progress event names even though separate SCORM / Program category chips may appear disabled in the UI |
| Meetup | Published / deleted meetups, occasions, attending, attendance submitted | Live learning events |
| SCORM / Program (UI) | Shown in Configure but not selectable today | Content-lifecycle SCORM/program webhooks are not implemented yet; subscribe to Progress for learner SCORM/program events |
Full eventType list: Event Catalog. Envelope and headers: Delivery Envelope.
Before You Start
- Have an HTTPS endpoint ready to accept Skillhabit’s delivery envelope.
- Know which categories you need; availability can vary—the UI shows what you can select.
- Plan to respond with
2xxquickly and deduplicate on deliveryidif retries occur.
How to Create a Webhook
- Open Configure → Connections → Webhooks.
- Choose Create a webhook.
- Set Endpoint (valid HTTPS URL), optional Description, and Enabled.
- Select at least one Event type (category).
- Optionally add Custom headers (name/value pairs) if your receiver needs them.
- Save.
Edit or delete webhooks from the list (delete one if you are at the five-webhook limit).
Product-only copy of these steps: Configure → Webhooks.
