# Blackboard

## Create Blackboard App in the Developer portal

The first thing you need is an app created in the developer portal. Navigate to [https://developer.blackboard.com ](https://developer.blackboard.com/)and signup for an account. When you are logged in, you can see a dashboard with a list of your applications and a button to create a new one:

<figure><img src="https://3302048229-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgz8UQyeLslUx9wCXYxF8%2Fuploads%2FKfoVS9Kd0SdL6exiXgca%2FMy_Applications.png?alt=media&#x26;token=caf970b4-89c2-4fc0-b94e-ca4d7f58cc74" alt=""><figcaption></figcaption></figure>

Note that listed applications have an Application ID. We will need it when we register our application in the blackboard instance. Click on the + button to create a new application. A simple form appears with your Application name and description inputs, and a *domains* input, for your domains. After you fill in the fields, create the new application.

## Register your application on Blackboard

### Self-managed instances

Log in with admin privileges, and go to the System Admin tab in the top menu. After that, look under Integrations for REST API Integrations:

<figure><img src="https://3302048229-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgz8UQyeLslUx9wCXYxF8%2Fuploads%2FRorDxfMQaGg16NlxB1i3%2FSystem_Admin_%E2%80%93_Blackboard_Learn.png?alt=media&#x26;token=9dbb4c72-9f72-4b42-ad40-5b7c88742256" alt=""><figcaption><p>REST API Integrations option</p></figcaption></figure>

Next, you will see a list with all your API Integrations. Click on Create Integration to add a new one:

<figure><img src="https://3302048229-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgz8UQyeLslUx9wCXYxF8%2Fuploads%2FiA849P50zJDSm4Ts589N%2FREST_API_Integrations_%E2%80%93_Blackboard_Learn.png?alt=media&#x26;token=6e29ec5c-bbdd-4c74-858b-1915d5f6c5e4" alt=""><figcaption><p>REST API Integrations list</p></figcaption></figure>

After that, you will show a small form. One of the inputs is the Application ID which as we showed in the first step, is available in the applications list at the developer portal. Next, browse and select a user. We recommend using the same user you are logged in with. On the *End User Access* and *Authorized To Act As User*, select Yes in both options. After that click on Submit to finish the registration.

## Configure the Backoffice

Finally, we need to set the OAuth clientId and clientSecret in the [Backoffice](https://docs.appmixer.com/6.0/v4.5/appmixer-backoffice) to finish the integration. To obtain these values, go to the applications list in the developer portal. Find your application and click on the 3 dots at the end of the row. Then click on the Manage Keys option:

<figure><img src="https://3302048229-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgz8UQyeLslUx9wCXYxF8%2Fuploads%2FiKKvgeBkiy3nnNGQ3zGf%2FMy_Applications.png?alt=media&#x26;token=13ce611c-a83e-49e9-9425-9c8b481fa2b1" alt=""><figcaption><p>Manage Keys in developer portal</p></figcaption></figure>

After you will see a list of your application keys. Click on the + sign to create a new key. Your key will be created and its information will be shown to you:

<figure><img src="https://3302048229-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgz8UQyeLslUx9wCXYxF8%2Fuploads%2FtbFgfGASyNZVgpJ8YasG%2FMy_Applications.png?alt=media&#x26;token=b7ab2554-48e7-4803-8af3-a4fd4a5c513f" alt=""><figcaption><p>Key information</p></figcaption></figure>

Be sure to store this information somewhere safe, as you won't be able to get it again.

Next, log into the Backoffice and go to Services. Next create a configuration for *appmixer:blackboard*. Finally, add your Application ID as *clientId* and Secret as *clientSecret.* Also set *serverUrl* to your instance URL:

<figure><img src="https://3302048229-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgz8UQyeLslUx9wCXYxF8%2Fuploads%2FSqdx4C1uzUglNukc7kpJ%2FAppmixer_Backoffice_-_Service_Configuration_%F0%9F%94%8A.png?alt=media&#x26;token=319b4f7e-c465-43ca-b74e-ee5c2fc58db3" alt=""><figcaption><p>Blackboard configuration</p></figcaption></figure>

And you are done! You are ready to use the Blackboard module.