Notifications

Notification Subscription Events

Subscription key: notification_subscription

Events delivered to your notification_subscription URL are fired when a notification is dispatched to a user on the platform. Notifications cover a wide range of user actions and system events across assignments, learning content, events, social features, goals, skills, mentorship, and account management.

notification.dispatched - Notification Event

Fired when a notification (prompt) is dispatched to a user.

Event type: notification.dispatched

Example payload:

{
  "eventType": "notification.dispatched",
  "tenantId": "acme-corp",
  "user": {
    "id": "507f1f77bcf86cd799439011",
    "reference": "EMP-1042",
    "firstName": "Jane",
    "lastName": "Smith",
    "email": "jane.smith@acme.com"
  },
  "notification": {
    "messageType": "assignment_created",
    "messageTitle": "Introduction to Leadership",
    "messageActions": [
      {
        "label": "View Assignment",
        "links": ["https://app.acme.com/learn/content/507f1f77bcf86cd799439011"]
      }
    ],
    "dispatchedAt": "2026-04-27T10:00:00.000Z",
    "createdAt": "2026-04-27T09:58:00.000Z"
  },
  "createdAt": "2026-04-27T09:58:00.000Z",
  "dispatchedAt": "2026-04-27T10:00:05.000Z"
}

Notification Types by Category

Assignments

• assignment_created — Assignment created for user
• assignment_updated — Assignment details updated
• assignment_open — Assignment became available
• assignment_due_soon — Assignment due date approaching
• assignment_removed — Assignment removed from user
• due_content — Content item due for completion
• overdue_content — Content item past due
• content_shared — Content shared with user
• release_notification — Release or campaign notification

Events

• event_occurrence_attendee_registered — User registered for event
• event_occurrence_attendee_registered_by_other — User registered by another person
• event_occurrence_updated — Event details updated
• event_occurrence_deleted — Event cancelled
• event_occurrence_attendee_cancelled — User cancelled attendance
• event_occurrence_attendee_cancelled_by_other — Cancellation by another person
• event_occurrence_attendee_reminder — Reminder before event
• event_occurrence_author_attendee_registered — Attendee registered (author view)
• event_occurrence_author_attendee_cancelled — Attendee cancelled (author view)
• event_occurrence_author_reminder — Reminder for event author
• event_occurrence_manager_attendee_registered — Manager view of registration
• event_occurrence_manager_multiple_attendee_registered — Multiple attendees registered
• event_subscription_space_available — Space available on waitlist
• event_author_waitlist_digest_daily — Daily waitlist digest for author
• employee_registered_for_an_event_occurrence — Manager notified of employee registration
• employee_cancelled_event_registration — Manager notified of cancellation

Social & Spaces

• post_liked — User post liked
• post_replied — Reply to user post
• post_comment_liked — Comment liked
• post_comment_mentioned — User mentioned in comment
• post_created — User created post
• post_flagged — Post flagged for moderation
• post_comment_flagged — Comment flagged for moderation
• users_mentioned — User mentioned in post
• content_comment — Comment on learning content
• mention_comment — Mentioned in content comment
• reply_comment — Reply to content comment
• content_moderation — Content flagged for moderation
• space_joined — User joined a space
• space_welcome_email — Welcome email to new space member
• user_followed — New follower
• collaboration_member_added_notification — Added to collaboration

Goals & Entries

• goal_created — Goal created
• goal_completed — Goal completed
• goal_deleted — Goal deleted
• entry_created — Entry created for goal
• entry_updated — Entry updated
• entry_deleted — Entry deleted
• entry_evidence_provided — Evidence submitted for review
• entry_evidence_approved — Evidence approved
• entry_evidence_rejected — Evidence rejected

Skills & Rewards

• skill_level_increased — Skill level advanced
• badge_awarded — Badge or achievement awarded

Mentorship

• mentorship_session_created — Mentorship session scheduled
• mentorship_session_updated — Session details updated
• mentorship_session_cancelled — Session cancelled
• mentorship_session_reminder — Reminder before session
• mentorship_match_created — Mentee matched with mentor

Manager

• manager_digest_weekly — Weekly team digest

User & Account

• user_created_welcome — Welcome notification for new user
• user_password_changed — Password changed
• user_self_deleted — Account deleted
• user_activation_code — Activation code sent
• email_custom_field_verification — Email verification required
• email_custom_field_expiring — Email verification expiring soon
• email_custom_field_expired — Email verification expired

Admin & System

• admin_onboarding_content_removed — Onboarding content removed
• upload_job_completed — User upload processed
• completions_import_success — Completions imported successfully
• completions_import_error — Completions import failed
• completions_import_content_not_found — Content not found during import
• completions_import_users_not_found — Users not found during import
• audience_member_import_completed — Audience import completed
• audience_member_import_failed — Audience import failed

Notes

• user fields — User details are enriched at dispatch time. Any field may be null if the user record could not be resolved at dispatch time.
• messageTitle — Human-readable description derived from the notification. For content/goal types this is the content/goal title; for social types this is the post/comment content or user name.
• messageActions — May be an empty array for notification types carrying no navigable action (e.g. password changes, activation codes, deletions).
• messageActions[].links — Contains one URL per tenant domain. Tenants may have multiple domains (e.g. primary + admin), producing multiple links per action.
• notification.dispatchedAt — When the prompt was dispatched by the prompt service. Differs from top-level dispatchedAt, which is when the webhook was sent.
• createdAt (top-level) — When the prompt record was created. Echoes notification.createdAt.
• dispatchedAt (top-level) — When the webhook request was dispatched to your endpoint.
• tenantId — Platform tenant identifier, not a UUID — typically a human-readable slug.