Arlo Integration User Guide

Connect your Arlo training management system to Promote for seamless learner enrolment. This article will guide you through the process step by step.

Content in this article

• Integration Overview 
• Integration Configuration 

  • Creating an OAuth client in Arlo 

  • Enabling the Arlo connector in Promote 

    • Create the integration in Promote 

    • Establish the connection with Arlo 

    • Finalize the integration

• Program Configuration

  • Arlo E-learning

  • Arlo Events

Integration Overview

What this integration does

The Arlo integration connects Promote with Arlo (arlo.co), a training management system used to manage and sell courses and events. When a learner registers for an event or e-learning in Arlo, they are automatically enrolled in the corresponding program in Promote and gain immediate access.

The integration works for both Arlo e-learning courses and in-person or virtual events, giving you flexibility in how you deliver training.

Why use it?

If you use Arlo to manage your training catalogue and registrations, this integration brings your two platforms together so that registrations in Arlo flow directly into Promote.

Learners can access their online materials right away, and your team benefits from a fully connected workflow from sign-up to learning.

This is ideal for training providers and L&D teams who manage a mix of live events and online content and want everything to work in sync.

Ready to get started? Follow the step-by-step setup guide below.

Integration Configuration

In order to establish a connection between Promote and Arlo, an initial configuration must be performed on both platforms. This section will guide you through that configuration.

1. Creating an OAuth client in Arlo

In order to connect Arlo to Promote an OAuth client must first be created in Arlo.

1. Go to https://portal.arlo.co/account/register/ and register an OAuth client
2. After registration, contact [e-mail] to request OAuth approval
3. Once approved, note down the Client ID and Client Secret

2. Enabling the Arlo connector in Promote

We will now enable the Arlo connector in Promote, which requires elevated privileges. To do so, the following steps should be taken by a user with administrative rights:

1. Log on to Promote and, under Admin, select the Users tab.
2. Search for and select the user who will configure the integration (this is most likely your own user.)
3. In the Edit user screen, under Admin permissions, check manage integrations, and save.

At this point, the Integrations tab will become visible in the top toolbar, giving you access to the connector configuration.

2.1 Create the integration in Promote

1. Select Integrations in the left hand menu.
2. Click + Add new
3. From the list of integrations select Arlo.
4. Optionally, give the application a descriptive name, such as Arlo Production or Arlo Staging, if you are establishing a connection to a production or staging environment respectively.
5. Insert the URL to your Arlo instance 
6. Select Authentication method: OAuth 2.0 (Client Credentials)
7. Insert the ClientID you got from Arlo in step 2.1.3
8. Insert the Client Secret you got from Arlo in step 2.1.3
9. Click the Save button to save the integration

2.2 Establish the connection with Arlo

1. Once the integration is saved with valid credentials, a Connect button will appear

2. Click the Connect button to initiate the OAuth flow

3. You will be redirected to Arlo to authorize the connection

4. After authorization, you will be redirected back to Promote

5. The connection status will show as "Connected" with a green badge 

2.3 Finalize the integration

1. Copy the Webhook URL
2. Go to Arlo at  https://{your-site}.arlo.co/management/Console/#/webhookendpoints/
3. Create a new endpoint
4. Insert Promote as Name
5. Leave Status set to Active
6. Paste the URL you copied into the Endpoint field
7. Leave Format set to JSON
8. Add your email as technical contact

9. Under Send these events select

   a. Registration.Created

   b. Registration.Updated.

10. Click Save - Once saved, a key will be generated. 
11. Under Key click Show the Key
12. Copy the value

13. Go back to the Arlo Integration view in Promote
14. Paste the key in the field Webhook secret key
15. Click Save

You now have established a connection between Arlo and Promote. This is a one-time configuration which should never have to be updated unless changes are made to the Arlo webhook endpoint or Arlo contact.

Program Configuration

Once a connection has been established between the two platforms, a Promote program can be linked to an Event or E-learning in Arlo to allow automatic enrollment for any users who registered via Arlo

1. Arlo E-learning

1. In Arlo, find the E-learning you want to connect to a Promote program
2. Go to Content and add the URL to your Promote site, for example https://demo.promotelogin.com
3. Go to General
4. Copy the code displayed under Elearning code

5. Log on to Promote
6. Find the program you want to link the Arlo E-learning to
7. Go to Settings for the program
8. Check the Allow members to access the program without requiring an invitation option to allow users to get access to the program after enrolling via Arlo

9. For self paced e-learning content it is also recommended to set

   a.  Learner interaction and communication - Individual program

   b. Timeline type - Individual start/end date

10. Under Integrations

    a. Paste the Elearning code you copied in Arlo in the Identifier field

    b. Select Arlo in the Integration field

11. Click Save changes

Your Arlo e-learning is now connected to your Promote program. When a user registers to the e-learning they will automatically be added to the program and they will be able to access the program immediately since it is configured to allow access without invitation emails and have individual start dates. It’s advisable to include instructions about how to sign in to Promote via link, in the confirmation email from Arlo.

The user will have access to the program for 12 months from the day they registered.

2 Arlo Events

1. In Arlo, find the Event you want to connect to a Promote program
2. Go to General
3. Copy the code displayed under Event code

4. Arlo Events, unlike Arlo Elearnings, do not have a link by default so make sure to include the URL to your Promote site in the confirmation email, plus information about how to sign to Promote via link
5. Log on to Promote
6. Find the program you want to link the Arlo Event to
7. Check the Allow members to access the program without requiring an invitation option to allow users to get access to Promote after enrolling via Arlo

8. For cohort programs it is also recommended to set

   a. Learner interaction and communication - Cohort program

   b. Timeline type - Program start/end date

9. Under Integrations

   a. Paste the Event code you copied in Arlo in the Identifier field

   b. Select Arlo in the Integration field

 

10. Click Save changes

Your Arlo e-learning is now connected to your Promote program. When a user registers to the e-learning they will automatically be added to the program.

Please note that when a program has a start date set in Promote, the user will not be able to visit the program until it opens. WIth the information provided in the confirmation email they can however sign in to Promote and see the upcoming program listed.