Security Journey Webhooks

Webhook Completion Notifications

Security Journey provides webhook notifications to help Admins track learner progress and trigger automated workflows. This feature sends a JSON payload anytime a user completes a path or a level, providing both a human-readable message and structured data you can use for custom integrations.

What This Feature Does

Whenever a learner completes a level or a path, the Security Journey webhook sends a JSON message to the configured endpoint.

This serves two purposes:

1. A clear training-status message (via the text field) for basic webhook integrations such as Slack or Microsoft Teams.

2. Structured data that Admins can use to build workflows, trigger automations, or construct customized completion messages.

Webhook Payloads

The structure of the message varies slightly depending on whether the user completed a level or a path.

Level Completion Payload

{
  "text":              "John Doe has completed the level Foundational!",
  "email":             "john_doe@securityjourney.com",
  "first_name":        "John",
  "last_name":         "Doe",
  "level_name":        "Foundational",
  "modules_completed": "24 of 24",
  "started_at":        "2024-05-21T00:43:16Z",
  "completed_at":      "2024-06-19T15:43:10Z"
}

Path Completion Payload

{
  "text":              "John Doe has completed the path Foundational – Basic Training!",
  "email":             "john_doe@test.com",
  "first_name":        "John",
  "last_name":         "Doe",
  "path_name":         "Foundational – Basic Training",
  "modules_completed": "24 of 24",
  "started_at":        "2024-05-21T00:43:16Z",
  "completed_at":      "2024-06-19T15:43:10Z"
}

Using the Webhook in Slack or Microsoft Teams

If the webhook is connected using the basic integration for Slack or MS Teams:

• Only the text field will be displayed in the channel.

• This provides a simple, user-friendly notification such as:
  “John Doe has completed the path Foundational – Basic Training!”

All other fields in the payload remain available for advanced workflow tools or custom processing.

Using the Additional Fields

Admins who want more control, such as building automations in tools like Zapier, Power Automate, or custom scripts, can use the additional fields to:

• Trigger notifications only when certain paths or levels are completed

• Log completion timestamps for reporting

• Update HR systems or LMS tools

• Customize messaging based on the learner or training type