Skip to main content

๐Ÿ“ก Understand and Use the Didask Public API

Connect Didask to your internal tools (HRIS, ERP, CRM) to automate account creation, training assignment, and usage data retrieval.

Written by Ocรฉane

โฑ๏ธ The Essentials in 3 Minutes
โ€‹
โ€ข What the Didask public API enables (create accounts, assign learning paths, retrieve usage data).
โ€ข The main use cases (HRIS, Salesforce, internal portal, targeted campaigns).
โ€ข How to get started (API key, test environment, Didask support).


๐Ÿง  Understand the Value of the Public API

A training platform never operates in isolation within an organization's information system - it communicates with the HRIS, ERP, CRM, and sometimes an employee portal. The Didask public API automates these exchanges so that training is fully integrated into your day-to-day operations.

In practice, this eliminates manual data entry (account creation, path assignment...), removes re-entry errors, and lets learning data flow where it is actually useful (HR dashboards, sales tracking, management reporting).


๐Ÿ” Understand What the Didask Public API Is

The Didask public API is a digital gateway that allows external applications (HRIS, ERP, LMS, CRM...) to communicate automatically with Didask.

In simple terms, it lets you:

  • Create or update users in Didask from another tool.

  • Automatically assign learning paths to users.

  • Retrieve usage data (completion rates, time spent) to display in your internal dashboards.

This automation saves time, prevents manual errors, and integrates training into your existing tools without friction.


๐Ÿ’ฐ Understand the Pricing Model

๐ŸŽ The API is included in your Didask license at no extra cost. You can start using it as soon as you are ready.

In return, you develop the connector yourself.

๐Ÿ’ก What is a connector? A connector is a small piece of software or script that acts as a bridge between two tools. It reads or writes data between your internal systems (e.g. HRIS) and Didask, via the API.

๐Ÿ“ž If you would like Didask to design, deploy, and maintain this connector for you, contact your Key Account Manager to discuss a tailored engagement.


๐Ÿงญ Identify Typical Use Cases

Use case

Concrete example

๐Ÿ”„ Automatically create learner accounts from an HRIS or ERP

A new employee is added to your HR tool: the API automatically creates their Didask account.

๐Ÿ“ค Push progress data to your systems

You use Salesforce to track skills development. Completion rates feed automatically into your HR dashboards.

๐Ÿงฉ Embed Didask data in your internal applications

You have an employee portal: the API displays each user's Didask learning paths directly, without them needing to log in to Didask.

๐Ÿงฎ Automate targeted training campaigns

A new employee joins your company: the API automatically triggers the assignment of the onboarding training.


๐Ÿ› ๏ธ Identify Available Features

Domain

Available actions

๐Ÿ‘ค User management

Create a new user - Update their information - Deactivate an account.

๐ŸŽฏ Path and module management

Assign a publication to a group - Assign a group to a user - Invite a user by email to their space or a specific publication.

๐Ÿ“Š Usage data extraction

Retrieve completion status - Time spent - Last activity - Export group results.


๐Ÿš€ Get Started: Generate Your API Key

โ„น๏ธ Creating an API key requires a platform administrator role.

How to generate an API key

  1. Go to your platform settings under the API keys section.

  2. Click Create an API key.

  3. Choose the permissions (scopes) to assign to the key. They are grouped by area and can be set to read or write:

    • auth, groups, managers, publications, spaces, users

  4. Click Create.

The key is displayed only once. Make sure to copy it and store it somewhere safe right away. If you lose it, you will need to create a new one, as Didask cannot show it again.

Good to know

  • Each key also has a fingerprint. This is a public ID that allows you to recognize the key in the list without revealing its actual content.

  • The API keys page lists all the workspace's keys: the creator's email address, the permissions (scopes), the creation date, and the last used date. Any platform admin can view and delete them, not just the person who created the key.

  • Keys apply to the entire workspace and cannot be restricted to a single space.


โ‰๏ธ Resolve Common Cases

Question

Answer

Is the API free?

โœ… Yes, included in your license if you develop the connector.

Do I need technical skills?

โŒ No to test. โœ… Yes for production (or get support).

Can I test before going live?

โœ… Yes, a test environment is available on request.

Can I stop using the API if I no longer need it?

โœ… Yes, you can revoke a key or stop the exchange at any time.

Can Didask help me implement it?

โœ… Yes, speak to your Key Account Manager.


๐Ÿ“ฉ Get Support from Didask

Our team is available to guide you on:

  • Retrieving your API key.

  • Initial testing in a dedicated environment.

  • Security best practices.

  • Developing a connector or connecting you with a partner integrator.

๐Ÿ‘‰ Speak to your CSM or contact support via your Didask interface.


๐Ÿ’ก Technical Resources (Admins and Integrators)

  • Generic API documentation: ๐Ÿ”— https://didask.didask.com/api/v1

  • Platform-specific documentation: yourplatformname.didask.com/api/v1 (Replace yourplatformname with your instance name.)


Keywords: public API, Didask API, connector, automation, HRIS, ERP, CRM, Salesforce, integration, API key, workflow, automatic onboarding.

Did this answer your question?