Damstra Learning Integration

The Damstra Learning integration automatically synchronises course completion data between your Damstra Learning LMS and MyPass. This direct LMS connection eliminates manual certificate entry, ensuring that when your personnel complete training, their certifications appear in MyPass in near real-time.

Note: This integration requires API access to be enabled for your MyPass account. If you don't currently have API permissions, contact support@mypassglobal.com and we'll enable it as part of the setup process.

Key Benefits

Saves Time: Eliminates manual certificate entry for you, reducing administrative overhead.
Near Real-Time Updates: Provides certificate updates typically within one minute of completion.
Comprehensive Data: Includes automatic PDF download from Damstra Learning.
Resilience: Built-in monitoring, error handling, and retry logic ensure data consistency.

Initial Setup and Personnel Linking

This section outlines the one-time actions you need to take to activate the integration and match your personnel.

Technical Setup

Action	Owner	Key Details/Rationale
Provide Damstra API Key	Customer	Provide the API key to MyPass. Crucially, do not click the Regenerate API Key button in Damstra, as it will break the integration.
Enable Webhook	Customer	Paste the Webhook URL into the Damstra Integrations section and select Lesson Schedule Completed as the triggering event.
MyPass Final Configuration	MyPass	MyPass completes the final configuration on the system side before activation.

Personnel Matching and Initial Sync

Action	Owner	Key Details/Rationale
Supply Initial Personnel List	Customer	Supply the list of personnel (exported from Damstra) for matching against existing MyPass profiles.
Address Personnel Discrepancies	Customer	If personnel don’t match (e.g., due to conflicting email addresses), you must correct the email address in Damstra Learning to match the personnel's MyPass email address to resolve the mismatch.
Receive Personnel Status Report	Customer	MyPass will send a spreadsheet back to you showing which personnel are "switched on" (linked) to track the initial pilot group.

Ongoing Operations and Course Management

How Course Completion Sync Works

Completion Trigger: A personnel finishes a course in Damstra Learning, triggering a webhook notification.
Attainment Creation: The attainment is instantly created in the personnel's MyPass profile, and the system distinguishes between a renewal and a duplicate based on the completion date.
Auto-Verification: The attainment is automatically verified only if the certificate name and the personnel's full name match exactly in both systems.

Course and Name Matching Requirements

Course Naming Alignment: Course names in Damstra and MyPass must match exactly for the system to auto-verify. Any mismatch will cause the attainment to require manual verification.
User Name Discrepancies: If a personnel's name is slightly different between the systems (e.g., "Chris" vs. "Christopher"), the attainment will be created in MyPass but flagged as Pending Verification (requiring human intervention).
New Course Rollout: When rolling out a new course, ensure to create an item in your Internal Library in MyPass with the exact same name as the course in Damstra.

New Personnel Management

Notification: For new personnel, you will use the shared email template to send the MyPass team the personnel's first name, last name, Damstra username, and MyPass email address. This information is needed to manually link the accounts.
Record Creation: The MyPass Team will create new records in MyPass where no match is found for the new personnel.
Data Cleaning: You may need to manually archive any old, duplicate certifications in MyPass that now exist as automated records from Damstra.

Troubleshooting and Escalation

Common Issues and Resolution

Symptom / Issue	Customer Action Required
Completed courses not appearing	Contact MyPass Support. Provide details on the affected personnel and the time frame of course completion.
Certificates not found/created	Verify Course Name Alignment. Check that the exact course name in Damstra matches the certificate name in your MyPass library. If not, correct the name in your MyPass library.
Personnel Matching Issues	Verify Personnel Details. Check the Damstra username and MyPass email address for the affected personnel for discrepancies. If the issue persists, contact MyPass Support at support@mypassglobal.com.
No webhook events received	Contact MyPass Support. This suggests a configuration issue with the webhook in your Damstra instance.

System Limitations

No Code-Based Matching: Matching is limited to the certificate name only (Damstra Learning does not support certificate codes).
No Self-Service Mapping: Personnel linking requires MyPass team involvement (no customer UI for self-service mapping). Download the Worker Mapping Template, complete it with your worker details, and send it to support@mypassglobal.com.
Failure Notification: MyPass has internal alerting for failures. However, please contact MyPass Support right away if you notice any certificates missing from a profile.

Updated 17 October 2025 00:58