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


---

# 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://guide.amanote.com/integration/blackboard/blackboard-ultra.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.