.png)
Docebo Integration Guide
Integrate Docebo with enterprise systems through REST APIs, selected webhook notifications, OAuth 2.0 authentication, and Martini workflows.
Docebo integration options at a glance
Docebo’s primary integration surface is its REST API, which supports users, courses, enrollments, learning plans, catalogs, sessions, certifications, and reporting operations. Docebo also provides webhook or event-notification capabilities for selected events, subject to tenant configuration and enabled features. OAuth 2.0 and access-token authentication protect API access. Martini can consume these APIs, receive selected webhook-style notifications, expose normalized REST APIs, and orchestrate scheduled synchronization workflows. Pagination, controlled batching, retries, and reconciliation support reliable processing where dedicated bulk endpoints or complete event coverage are unavailable. Reporting data can be normalized and delivered to downstream operational or analytical systems.
Common Docebo integration patterns
Common Docebo data objects used in integrations
Authentication and security considerations
OAuth 2.0 and access tokens
Docebo integrations generally use OAuth 2.0 and access-token-based API authentication configured for the tenant. The exact grant, scopes, and token behavior should be verified against the current tenant documentation.
Credentials and permissions
Martini can store client IDs, client secrets, token endpoints, instance URLs, and environment-specific values as secrets. Docebo roles, tenant permissions, branches, and groups determine which Users, Courses, Enrollments, Reports, and other resources are accessible.
Data protection
- Use least-privileged API clients and users.
- Keep tokens and client secrets out of payloads and logs.
- Protect learner, completion, and certification data in transit and at rest.
- Use separate configuration for different Docebo environments.
Operational considerations for Docebo integrations
Rate limits and pagination
Confirm tenant and endpoint limits, process paginated responses, use bounded concurrency, and apply exponential backoff for HTTP 429 and transient 5xx responses.
Idempotency and reconciliation
Use stable Docebo IDs and cross-reference tables for Users, Courses, Enrollments, sessions, and Certifications. Treat webhook deliveries as potentially duplicated and run periodic reconciliation to detect missed updates.
Webhook reliability
Validate configured webhook authentication, acknowledge promptly where required, record event fingerprints, and retrieve authoritative state when payloads are incomplete.
Schema and tenant variation
Fields and behavior can vary by API version, enabled modules, custom fields, and tenant configuration. Test mappings after configuration or API changes and preserve unknown fields where practical.
Testing and monitoring
Separate validation, authorization, throttling, and transient errors. Monitor workflow logs, capture permitted response details, and route failed records to retry or exception workflows.
Why use Martini instead of scripts or point-to-point integrations?
Orchestration instead of isolated scripts
Martini coordinates Docebo API calls, webhook intake, scheduled reconciliation, target writes, and exception handling in maintainable workflows rather than scattering logic across scripts.
Reusable integration logic
Authentication, pagination, correlation, validation, mapping, and retry behavior can be implemented as reusable integration assets and applied across multiple Docebo flows.
Controlled enterprise interfaces
Martini can expose normalized REST APIs so downstream applications use a stable enterprise contract while Docebo-specific authentication, permissions, transformations, and business rules remain centralized.
Operational reliability
- Support scheduled, event-driven, API-led, and batch processing patterns.
- Separate transient failures from permanent validation errors.
- Use checkpoints, deduplication, retries, and reconciliation.
- Monitor workflows and troubleshoot integration behavior centrally.