MentivisOS API

MentivisOS exposes a RESTful API that integrates adaptive training, skills management and certification features into your existing tools.

The API covers: - Learner management (creation, update, sync) - Adaptive learning paths and their triggering - Progress and results tracking - Certificate and badge delivery - Skills data export to your target systems

The API is available at: https://api.mentivisos.com/v1

Authentication

All API requests require a Bearer token in the Authorization header:

Authorization: Bearer <your_api_key>

API keys are available from your MentivisOS dashboard under "Developers" > "API Keys".

Rate Limits

• 1000 requests / hour for Essential plan
• 5000 requests / hour for Business plan
• 20 000 requests / hour for Enterprise plan

Encoding

All requests and responses use JSON. Make sure to set the Content-Type: application/json header.

Idempotency

Creation requests can include an Idempotency-Key header to prevent duplicates on retry.

Integration with ATS (Applicant Tracking Systems) enables training data synchronization directly in the candidate journey.

Taleez

Taleez is a collaborative French ATS used by SMBs and mid-market companies. Integration with MentivisOS provides: - Automatic creation of an adaptive learning path when a candidate reaches a specific status (e.g. "Interview passed") - Sending training results to the Taleez candidate profile via the Taleez REST API - Syncing evaluated skills from MentivisOS repository to Taleez custom fields

Flatchr

Flatchr offers AI-powered features and multi-posting. The MentivisOS integration: - Triggers pre-hire modules (early onboarding) via webhook - Reports completion rates and scores in the Flatchr dashboard - Feeds candidate scoring with MentivisOS assessment results

JobAffinity

JobAffinity is an ATS for small businesses and public administrations. Integration: - Synced skills mind map between both tools - Automatic import of candidates from JobAffinity to a pre-qualification path - Skills passport export to the candidate file

HelloWork Recruteur

HelloWork Recruteur (formerly App Recruteur) is France's leading private employment platform. - Job posting paired with a link to a MentivisOS discovery path - Assessment results received directly in the candidate database - CV enrichment with skills validated via MentivisOS

Integration with HRIS keeps the skills repository up to date and enables training management from the central HR tool.

Eurécia

Eurécia offers a complete HR suite with ATS module, onboarding and talent management. - Skills repository sync between Eurécia and MentivisOS - Automatic learning path triggering after performance reviews - Training records pushed to the Eurécia employee file

Empowill

Empowill is an HR solution specialized in talent management for SMBs. - Development plans synced with MentivisOS learning paths - Mandatory certification tracking in the Empowill dashboard - Post-training skills assessment import

Kelio

Kelio is a comprehensive HRIS used by mid-market and enterprise companies. - Training data export to Kelio for administrative management - Training schedule sync via API - Training hours reporting to DIF/CPF

Sage HR

Sage HR is deployed in over 40,000 companies in France. - Dedicated connector for training data exchange - Automatic employee sync with their ID - Skills development plan feeding

Personio

Personio is an HRIS adopted by hyper-growth SMBs. - REST API integration for profile creation and updates - Custom attribute sync (skills, certifications) - Automated workflow triggering an onboarding path upon hire

Pennylane is a French all-in-one financial management platform: invoicing, accounting, treasury, expense reports and payroll.

The MentivisOS-Pennylane integration automates the financial side of training:

Training Invoicing

• Validated training sessions automatically generate a customer invoice in Pennylane via the Company API
• Product and training price sync (MentivisOS catalog → Pennylane product base)
• Invoice matching with purchase orders and signed quotes

Cost Tracking

• Training costs (instructors, platform, resources) are synced in accounting entries
• Instructor expense reports from Pennylane are linked to training sessions
• Analytical dashboards: cost per learner, per module, per department

OAuth 2.0 Certification

• Integration uses the Pennylane OAuth 2.0 flow (Company API)
• A test sandbox is available in your Pennylane workspace
• Pennylane webhooks notify MentivisOS of invoice status changes (paid, unpaid, sent)

Technical Reference

Pennylane API v2: https://pennylane.readme.io/ Key endpoints: /api/external/v2/customer_invoices, /api/external/v2/products, /api/external/v2/changelogs/customer_invoices

Webhooks allow MentivisOS to notify your systems in real-time on key events.

Available Events

• learning_path.completed — A learner has finished a path
• assessment.passed — An assessment has been passed
• certificate.issued — A certificate has been issued
• learner.enrolled — A learner has been enrolled in a path
• learner.skill_updated — A learner's skills have been updated

Configuration

Webhooks are configurable from the MentivisOS dashboard: 1. Go to "Developers" > "Webhooks" 2. Add your endpoint URL 3. Select the events to listen to 4. Validate with the verification handshake

Signature

Each payload is signed with HMAC-SHA256. The X-Mentivis-Signature header contains the signature to verify with your shared secret.

Expected Response

Your endpoint must respond within 2 seconds with HTTP 200. On failure, MentivisOS retries up to 5 times with exponential backoff.

A test environment is available to validate your integrations without impacting production.

Sandbox Environment

API URL: https://sandbox-api.mentivisos.com/v1 Data is reset every week.

Creating a Sandbox Account

1. From your MentivisOS dashboard, go to "Developers" 2. Click "Create a test environment" 3. Generate a sandbox API key separate from your production key 4. Use pre-loaded demo data (learners, paths, modules)

Recommended Test Scenarios

• Create a learner → enroll in a path → track progress
• Simulate an incoming webhook from your ATS
• Sync skills to your HRIS
• Generate a training invoice to Pennylane

Sandbox Limitations

• 500 requests / hour
• No real email sending
• Webhooks are simulated (viewable in logs)
• Generated certificates are marked "TEST"