# Annoto Integration

## Overview

This document shows how to add Annoto to your Blackboard environment.

## Creating a Tool Provider <a href="#toc95098660" id="toc95098660"></a>

This section describes how to create a Tool Provider so that you can deploy the Annoto Extension for Blackboard. The Tool Provider allows you to enter the Annoto key and secret one time for all the Annoto tools.

**To Create the Tool Provider**:

* [ ] Login to Blackboard as an admin.
* [ ] Go to “Administrator Tools” and select LTI Tool Providers.

![](/files/1QzQJCJMAvJJgqksvWuk)

* [ ] Navigate to the “Register LTI 1.1 Provider (In old versions its called “Register Provider Domain”) tab

![](/files/1JpCfXaHfUKROCqrP5Ml)

* [ ] Set the **PROVIDER DOMAIN STATUS**:
  * “Provider Domain”:
    * EU Deployment: **auth.eu.annoto.net**
    * US Deployment: **auth.us.annoto.net**
  * Provider Domain Status: **Approved**
* [ ] Set the **DEFAULT CONFIGURATION**:
  * Set the “Default Configuration” to “**Set globally**”
  * Tool Provider Key: Use your Annoto API Key (ClientID)
  * Tool Provider Secret: Use your Annoto Secret

{% hint style="info" %}
This key and shared secret is provided by Annoto, If you do not have this information, please contact us:  [support@annoto.net](http://support@annoto.net/)
{% endhint %}

* [ ] Set the **INSTITUTION POLICIES:**

![](/files/Y70mKqAmTCE3XWe8CqpS)

* [ ] Click **Submit**

## Deploying the Annoto Tools to Your Blackboard Environment <a href="#toc95098661" id="toc95098661"></a>

This section describes how to add the following tools to your Blackboard environment:

* Annoto Widget Embed
* Annoto insights dashboard

- [ ] Login to Blackboard Ultra as an admin.
- [ ] Go to “Administrator Tools” and click on LTI Tool Providers.
- [ ] Navigate to the “Register Provider Domain” tab and locate the Tool/Provider you created.
- [ ] Click **Manage Placements**.

![](/files/Hbp9pBLuogzath2DvNoz)

Click **Create Placement**.

![dasCreate a placement with the following information:](/files/errcZcsvCBvpIigsDHfW)

* [ ] Label: **Annoto Widget Embed**

* [ ] Handle: **Annoto-lti01**

* [ ] Availability: **Yes**

* [ ] Type: **“Deep Linking content tool”**

* [ ] Icon: The Annoto Icon can be downloaded from: <https://cdn.annoto.net/assets/latest/images/icon.svg>

* [ ] Tool Provider URL: Fill in the following URL:
  * EU Deployment: <https://auth.eu.annoto.net/lti/item-embed>
  * US Deployment: <https://auth.us.annoto.net/lti/item-embed>

* [ ] Click **Submit**.

### Annoto insights dashboard <a href="#toc95098663" id="toc95098663"></a>

Create a placement with the following information:

* [ ] Label: **Annoto Dashboard**
* [ ] Handle: **AnnotoDash**
* [ ] Availability: **Yes**
* [ ] Type: **“Course tool”**
* [ ] Icon: The Annoto Icon can be downloaded from: <https://cdn.annoto.net/assets/latest/images/icon.svg>
* [ ] Tool Provider URL: Fill in the following URL:
  * EU Deployment: <https://auth.eu.annoto.net/lti/course-insights>
  * US Deployment: <https://auth.us.annoto.net/lti/course-insights>
* [ ] Click **Submit**.


---

# 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://docs.annoto.net/setup-guides/blackboard/legacy/annoto-integration.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.
