Set up a connection to Docebo

Docebo is a multi-product learning suite that helps enterprises to tackle learning challenges and to create a successful learning culture.

Docebo documentation: API guide, Authentication
Additional reference: Supported Docebo APIs

Contents

• A. Connect to Docebo
• B. Specify application details for the connection
• C. Specify advanced connection settings (optional)
• D. Authorize the connection

A. Connect to Docebo 

First, connect to the Docebo application.

Create a connection in either of the following ways:

• From the Resources menu, select Connections. Then, click + Create connection at the top right.
      – or –
• While working in a new or existing integration, you can add an application to a flow simply by clicking Add source or Add destination/lookup.

In the resulting Application list, select Docebo. The Create connection pane opens with required and advanced settings.

B. Specify application details for the connection

Next, provide general and required Docebo application details for this connection.

Name (required): Provide a clear and distinguishable name. Throughout integrator.io imports and exports, you will have the option to choose this new connection, and a unique identifier will prove helpful later when selecting among a list of connections that you’ve created.

Application (required, non-editable): The application to which you are connecting. In this case, it is Docebo. 

Base URI (required): Enter your Docebo instance URI. For example, log in to your Docebo account, and if https://yoursubdomain.docebosaas.com/learn/signin is the login URL, then enter https://yoursubdomain.docebosaas.com for this setting.

iClient (required): Click the plus (+) button to add an iClient and configure your credentials.

Important: Before you enter these details, create an API application in Docebo and configure the authentication. You can then map the required values for iClient in integrator.io to authenticate and use Docebo APIs. For the procedure, see the link below.

In Name, enter a meaningful name, for example, DoceboAPIApp. Then go to your Docebo account and copy the values for Client ID and Client Secret and paste them in the fields here. When editing this form later, you must enter these values again; it is stored only for a saved connection.

To create an API application in Docebo and retrieve the iClient details

1. Sign in to Docebo account at APIs Authentication.
2. At the top left, click the Settings gear icon to access the Admin menu.
3. In the Learn LMS page, click Add New Apps.
4. On the Apps and Features page, select Third  party integrations.
5. Under Third party integrations, in the row for API and SSO app, click the setup icon.
6. Read the information in the dialog, click Install Now.
7. After installation, in the Admin menu, go to the API and SSO section, then click Manage.
8. On the API and SSO page, select API Credentials. Under API Credentials click the Add OAuth2 App icon.
9. In the Add OAuth2 App page, provide the following details:
   1. App Name: Enter a meaningful name for the new app.
   2. App Description: Enter a brief description for the app.
   3. Client ID: Enter a name that can be used as the ID.
   4. Redirect URI: From integrator.io Create Connection page, copy the Redirect URL path (See the following Redirect URL description)and paste it.
   5. Advanced: If required, you can view and enter the settings.
10. Click Confirm after you make sure that you have selected the grant types.
    The newly created app is listed under Applications allowed to use OAuth2.
11. Click the checkmark icon at the end of the Applications allowed to use OAuth2 row to activate it.
    For more information, see Authentication.

Redirect URL (read-only): Copy this integrator.io callback URL and paste it in the Redirect URI field in Docebo when configuring the Docebo API  app to provide directions to Docebo for where to go after authentication. This URL should be whitelisted with the authorization server.

C. Specify advanced connection settings (optional)

If required, specify the advanced settings.

Borrow concurrency from (optional): Select another connection from the list. By default, all data flowing through a connection record is submitted to the respective endpoint application at the Concurrency level configured for that connection record. There are cases, however, where multiple integrator.io connections need to share the same concurrency level, and this field allows you to specify which connection you would like to borrow from. With borrowed concurrency, the data flowing through both connections will be submitted to the endpoint application together, via a shared concurrency model.

NOTE: Selecting another connection from the drop-down list changes the form. The concurrency level will be hidden, set to the same shared value as the other connections.

Concurrency level (optional): Set this field to limit the number of concurrent HTTP requests (up to 25) allowed by the connection resource at any one time, or leave this field blank to use burst mode. With burst mode, integrator.io will make HTTP requests as fast as possible, with high levels of concurrency.

D. Authorize the connection

Finally, authorize the newly created connection to Docebo.

Click Save & authorize. When you are prompted to authorize the OAuth2 App that you had created in Docebo, click Authorize.

You will receive a successful connection message. If you receive an error message, check your OAuth configuration in Docebo and the integrator.io connection settings. After making corrections, click Save & authorize again.