# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.codechum.com/teachers/advanced-guide/lms-integration/initial-setup-admin/blackboard.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.