How do I set up the Degreed integration with Blue Ocean Brain (BOB) for my organization?

These setup instructions will allow the BOB application to synchronize content and course completions with the Degreed platform.

Table of Contents

What are the advantages of setting up the Degreed integration?

How does the Degreed adapter sync content from Blue Ocean Brain to Degreed?

How will the Blue Ocean Brain content display and function within Degreed?

What needs to be enabled prior to setting up the Degreed adapter?

What are the steps to set up my Degreed adapter?

Step 1: Reach out to your Degreed rep to set up the Degreed integration.

Step 1a: If you are setting up SSO for the first time with Blue Ocean Brain, decide who will be the SSO IDP.

Step 2: Contact Blue Ocean Brain with the details of your Degreed integration.

Step 3: Confirm the test lesson in Degreed.

Step 4: Confirm that the Library of content is available.

Step 5: Confirm that the completions have passed over properly (if needed).


What are the advantages of setting up the Degreed integration?

Your company may already have access to the Blue Ocean Brain platform. With the addition of a BOB integration with Degreed, you can enhance your BOB experience to meet your learning goals for your employees:

  • Create a one-stop-shop. With the addition of the content integration, your learners can access BOB content directly within Degreed so that employees find the lessons and articles where they are already completing learning. Your learners will still be able to access the BOB platform to take advantage of the brain exercises, leaderboard, and Library, but this provides an additional method for employees to find BOB content for their just-in-time learning needs.
  • Incorporate BOB data into your Degreed reporting. BOB does have downloadable CSV reports available within the BOB Reports Admin portal that can be leveraged for reporting. By enabling the BOB integration with Degreed, the completion data will automatically appear on the lessons/articles in Degreed for your learners, and you as a leader can see your employees' BOB metrics available within the reporting area for the completion of all the content within your learning system.

How does the Degreed adapter sync content from Blue Ocean Brain to Degreed?

The Blue Ocean Brain app maintains and controls the Degreed integration through a one-way sync, with BOB writing to Degreed's public API in real-time.

New/Current Content

As content is added to your company's Blue Ocean Brain Library of content, the Lessons are automatically added to Degreed.

Retired Content

When Lessons are retired from Blue Ocean Brain, at the time when they're removed from your company's BOB Library, they are automatically removed from Degreed as well.


How will the Blue Ocean Brain content display and function within Degreed?

Once the Degreed integration is set up, the Blue Ocean Brain content will display within Degreed. How you configure your content in Degreed (i.e. whether to send in Lessons, Articles, or both; whether to send Articles as a course or Lessons as a course) will determine what content may appear in the search results and in which format.

The Learner experience will be as follows:

  • The Learner can search for Blue Ocean Brain content within the Search bar.
    • When Blue Ocean Brain content appears within the search results, the Learner will select a Lesson or Article.
    • The Learner, after selecting the BOB link, will be directed to a new tab that opens to the BOB Lesson.
    • Once the Learner reads all three Articles and answers the Show What You Know Questions, the Learner's completions will be sent over to Degreed in real-time.
    • The Learner may then view their completion of the Lesson on the Degreed page.
  • The Learner may select Blue Ocean Brain under the Featured Providers section of Degreed.
    • When the Learner selects Blue Ocean Brain under Featured Providers, a new window will open.
    • The Learner will be directed to the Blue Ocean Brain dashboard, where they may see the most current Lesson, the Library of content, Bookmarks, My Profile, and other company-selected features, such as the Leaderboard or My Learning sections.

What needs to be enabled prior to setting up the Degreed adapter?

SSO authentication needs to be set up with BOB. Your BOB IT contact will reach out to you to set up the BOB SSO profile. Here is more information regarding the SSO setup process with BOB.


What are the steps to set up my Degreed adapter?

The following steps will need to be completed for each Degreed tenant you set up with Blue Ocean Brain. 

Step 1: Reach out to your Degreed representative to set up the Degreed integration.

If the Degreed rep isn't already involved in the adapter setup, you'll need to contact the Degreed rep to begin the integration. Be sure the Degreed rep knows that BOB will need read and write access for the integration.

Blue Ocean Brain supports two integrations with Degreed:

  • Lesson Catalog
  • Content completions

This integration does NOT support "Required Learning."

Blue Ocean Brain should be set up as a Featured Provider.

Step 1a: If you are setting up SSO for the first time with Blue Ocean Brain, decide who will be the SSO IDP.

If you have already set up SSO with Blue Ocean Brain, skip to Step 2.

If you have NOT already set up SSO with Blue Ocean Brain, you will need to decide if you want your SSO provider to be the IDP or if you would like Degreed to be the IDP.

SSO will need to be set up before the Degreed integration can begin.

IDP Comparisons Degreed as SSO Provider Client's SSO Provider
How It Works The Learner visits Degreed to engage in BOB content. They must select the "Blue Ocean Brain" site link within Degreed to access BOB. The Client may visit Degreed or BOB; they will be prompted to log in via SSO for both. Employees can access the BOB platform.
How does the Learner access?
  • Degreed URL
  • Link or iFrame in the client's LMS
  • BOB platform
  • BOB mobile app
  • Degreed URL
  • Link or iFrame in the Client's LMS

Step 2: Contact Blue Ocean Brain with the details of your Degreed integration.

Once SSO has been set up, send the following information to your Blue Ocean Brain Client Success Manager or Blue Ocean Brain IT contact:

Note: A Blue Ocean Brain "Lesson" consists of three articles.

  • Client ID
  • Client Secret
  • Which content types you'd like to host in Degreed. The options are:
    • Lessons
    • Lessons AND Articles
  • How you want the content to flow into Degreed. The options are:
    • Send the overall lesson in as a Lesson and the articles as Articles  (This is the typical setup)

    • All content flows in as Articles

    • All content flows in as Lessons (This is the setup when the Client only wants the overall topic to flow into Degreed)

  • Do you want completion metrics sent to Degreed? (API sends over completion data in real-time)

Step 3: Confirm the test lesson in Degreed.

Once the Blue Ocean Brain team has set up the integration on their end, they will push in a test Lesson, and they will provide you with the name of the Lesson.

Search in Degreed to find the Lesson and make sure to complete the Lesson and check to see completions.

Let your Blue Ocean Brain Client Success Manager, Blue Ocean Brain IT contact, and Degreed rep know whether or not the test worked. They will troubleshoot with you if you experience any trouble.

Step 4: Confirm that the Library of content is available.

Once you confirm you are able to successfully test the Lesson, the Blue Ocean Brain team will confirm with you if you are ready to receive the whole Library.

Once the Library is pushed into Degreed, confirm that you are able to see the Library on your end.

Step 5: Confirm that the completions have passed over properly (if needed).

Once the Library is pushed into Degreed, if your Learners have already been using Blue Ocean Brain without the Degreed adapter, your BOB team will need to push in the completions of the content completed in the past. They will let you know once this is completed.