> For the complete documentation index, see [llms.txt](https://help.codechum.com/teachers/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.codechum.com/teachers/advanced-guide/lms-integration/initial-setup-admin/blackboard.md).

# Blackboard

This guide provides step-by-step instructions for Moodle administrators to integrate Blackboard with CodeChum. Follow the steps carefully to ensure a successful setup.

***

<details>

<summary>1. Register your Domain with CodeChum</summary>

* <mark style="color:blue;">**Objective:**</mark> Enable your Blackboard domain to connect with CodeChum’s API.
* <mark style="color:blue;">**Steps:**</mark>
  1. Email your Blackboard website URL to [`cymmer@codechum.com`](mailto:cymmer@codechum.com).
  2. Wait for confirmation from `cymmer@codechum.com`. You will receive an application ID once your domain is registered with CodeChum’s Blackboard application.

</details>

<details>

<summary>2. Create a CodeChum User in Blackboard</summary>

* <mark style="color:blue;">**Objective:**</mark> Set up a dedicated user in Blackboard that CodeChum will use for integration.
* <mark style="color:blue;">**Steps:**</mark>
  1. Log in to Blackboard and navigate to **System Admin > Users**.
  2. Click on **Create User**.
  3. Fill in the following fields:
     * **First Name:** Code
     * **Last Name:** Chum
     * **Username:** code-chum
     * **New Password:** Generate a secure random password (save this password for later use).
     * **Verify New Password:** Re-enter the generated password.
     * **Institution Roles:** Set **Faculty** as the Primary Institution Role.
     * **System Roles:** Assign the **Course Administrator** role.

</details>

<details>

<summary>3. Add CodeChum to REST API Integrations</summary>

* <mark style="color:blue;">**Objective:**</mark> Grant CodeChum access to Blackboard’s REST API.
* <mark style="color:blue;">**Steps:**</mark>
  1. Log in to Blackboard as an administrator.
  2. Navigate to **System Admin > Integrations > REST API Integrations**.
  3. Click on **Create Integration**.
  4. Enter the application ID you received from [`cymmer@codechum.com`](mailto:cymmer@codechum.com).
  5. Set the **Learn User** to `code-chum` (the user created in Step 2).
  6. Set **End User Access** to **Yes**.
  7. Set **Authorized To Act as User** to **No**.

</details>

<details>

<summary>4. Verify Integration with CodeChum</summary>

* <mark style="color:blue;">**Objective:**</mark> Confirm that the integration with Blackboard is successful.
* <mark style="color:blue;">**Steps:**</mark>
  * Email [`cymmer@codechum.com`](mailto:cymmer@codechum.com) to notify them that you’ve completed the integration steps. Include the password for the `code-chum` user.
  * Await confirmation from CodeChum.
  * Once you receive confirmation that everything is set up correctly, the integration process is complete.

</details>