Trackable links provide a way to deliver Coassemble courses outside of the Academy while still tracking learner progress. They allow you to share or embed courses in your own platform, website, or application, and associate activity with a unique learner identifier.
This feature is ideal for customers who want to integrate training into an existing system.
Read the developer documentation for Trackable links here.
What are trackable links?
A trackable link is a special course URL that includes a unique identifier passed from your system to Coassemble. When a learner accesses a course using this link, Coassemble records their progress against that identifier.
Trackable links behave like standard course share or preview links, with the added benefit of learner-level tracking.
What can trackable links be used for?
Trackable links are commonly used to:
Deliver training inside another platform, such as an HR system, intranet, or customer portal
Track learner progress without requiring users to log in to Coassemble
Associate course activity with an external user ID, email address, or customer reference
This makes trackable links well suited to people tech platforms, customer education portals, membership sites, and internal systems that want to surface training seamlessly.
How trackable links work
When generating a trackable link, you pass an identifier from your system using the id parameter. This identifier represents the learner and is used by Coassemble to record progress.
If the id parameter is not included, the course will still open, but learner progress will not be tracked.
Example format:
https://youracademy.coassemble.com/enter/TRACKABLE_LINK_KEY?id=USER123
The identifier can be any value that is meaningful to your system, such as a user ID or email address.
Optional: securing trackable links with a hash
For additional security, trackable links can include a hash parameter. This prevents the learner identifier from being modified.
The hash is generated using an HMAC-SHA256 hex digest of the id, created with a shared secret.
Example format:
https://youracademy.coassemble.com/enter/TRACKABLE_LINK_KEY?id=USER123&hash=GENERATED_HASH
When a hash is included, Coassemble validates the link before allowing access.
Embedding trackable links
Trackable links can be embedded in an iframe within your platform. When embedded, Coassemble can emit progress events that your application can listen to and act on, such as:
Course started
Module completed
Quiz completed
Course completed
This allows you to build custom experiences, trigger workflows, or store progress data in your own reporting systems.
Viewing learner progress
When learners access a course through a trackable link, Coassemble records progress automatically using the identifier provided.
You can then:
View learner progress within Coassemble reporting
Retrieve progress and completion data via the Coassemble API
Combine Coassemble data with your own platform reporting
This ensures a consistent and reliable view of learner engagement, even when courses are delivered outside of Academy.