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

# Blackboard Ultra

## 1. Create the REST API Integration

First, you need to create a new REST API integration for Amanote.

* Navigate to REST API Integration (`Administrator Tools > Integrations > REST API Integrations`).
* Click on **Create Integration**.

Enter the following configuration.

<table data-full-width="false"><thead><tr><th>Configuration</th><th>Value</th></tr></thead><tbody><tr><td><strong>Application ID</strong></td><td>1936f944-4760-48d2-ae1b-c76855b9859e</td></tr><tr><td><strong>Learn User</strong></td><td>administrator </td></tr><tr><td><strong>End User Access</strong></td><td>Yes</td></tr><tr><td><strong>Authorized To Act As User</strong></td><td>Yes</td></tr></tbody></table>

{% hint style="info" %}
You can also create a new Amanote user and select this new user instead of using the administrator user.
{% endhint %}

## 2. Register the LTI Tool Provider

Then, you need to register Amanote as an LTI 1.3 provider.

* Navigate to LTI Tool Providers (`Administrator Tools > Integrations > LTI Tool Providers`).
* Click on **Register LTI 1.3/Advantage Tool**.

Enter the following configuration.

<table data-full-width="false"><thead><tr><th>Configuration</th><th>Value</th></tr></thead><tbody><tr><td><strong>Client ID</strong></td><td>1936f944-4760-48d2-ae1b-c76855b9859e</td></tr><tr><td><strong>User Fields to Send</strong></td><td>Role in Course</td></tr><tr><td><strong>Show User Acknowledgment Message</strong></td><td>No</td></tr></tbody></table>

{% hint style="info" %}
Make sure that "Show User Acknowledgment Message" option is set to **No**.&#x20;
{% endhint %}

## 3. Create a new Ultra Placement

Create a new placement for the newly created LTI integration.

* Navigate to LTI Tool Providers (`Administrator Tools > Integrations > LTI Tool Providers`)
* Click the Amanote integration **dropdown icon** in the list of LTI Tool Providers.
* Click on **Manage Placements** in the dropdown menu.
* Then, click on **Create Placement**.

<table data-full-width="false"><thead><tr><th>Configuration</th><th>Value</th></tr></thead><tbody><tr><td><strong>Label</strong></td><td>Amanote UEF</td></tr><tr><td><strong>Handle</strong></td><td>amanote-uef</td></tr><tr><td><strong>Availability</strong></td><td>Yes</td></tr><tr><td><strong>Type</strong></td><td>Ultra extension</td></tr><tr><td><strong>Target Link URI</strong></td><td>https://api.amanote.com/integration/lti/launch/</td></tr></tbody></table>

## 4. Configure Cross-Origin Resource Sharing

* Administrator Panel > Cross-Origin Resource Sharing > Create Configuration
* Fill in the form as follows

| Configuration       | Value                        |
| ------------------- | ---------------------------- |
| **Origin**          | https\://**api**.amanote.com |
| **Allowed Headers** | \*                           |
| **Available**       | Yes                          |

* Create second Cross-Origin Resource Sharing as follows

| Configuration       | Value                        |
| ------------------- | ---------------------------- |
| **Origin**          | https\://**app**.amanote.com |
| **Allowed Headers** | \*                           |
| **Available**       | Yes                          |

## Test the integration

Once Amanote is properly installed on your LMS, a panel should appear next to supported course materials. This panel allows learners to annotate the course material on Amanote.

<figure><img src="https://amanote.com/static/e1100d9182d57908ca49706f2f2048a9/aa7f5/button-next-to-pdf.webp" alt=""><figcaption></figcaption></figure>

If you require any further assistance, feel free to contact us at <blackboard@amanote.com>.

<br>