> ## Documentation Index
> Fetch the complete documentation index at: https://docs.keephq.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# ThousandEyes

> ThousandEyes allows you to receive alerts from ThousandEyes using API endpoints as well as webhooks

## Authentication

This provider requires authentication.

* **oauth2\_token**: OAuth2 Bearer Token (required: True, sensitive: True)

Certain scopes may be required to perform specific actions or queries via the provider. Below is a summary of relevant scopes and their use cases:

* **authenticated**: User is Authenticated

## In workflows

This provider can't be used as a "step" or "action" in workflows. If you want to use it, please let us know by creating an issue in the [GitHub repository](https://github.com/keephq/keep/issues).

## Connecting ThousandEyes to Keep

1. Go to [ThousandEyes Dashboard](https://app.thousandeyes.com/dashboard)

2. Click on `Manage` in the left sidebar and select `Account Settings`.

<Frame width="100" height="200">
  <img height="10" src="https://mintcdn.com/keep-docs/oOz41askvZuXfasg/images/thousandeyes-provider_1.png?fit=max&auto=format&n=oOz41askvZuXfasg&q=85&s=8b77cc8b86652f7d1ce2f24cff7b0401" data-path="images/thousandeyes-provider_1.png" />
</Frame>

3. Select `Users and Roles` in the Account Settings

<Frame width="100" height="200">
  <img height="10" src="https://mintcdn.com/keep-docs/oOz41askvZuXfasg/images/thousandeyes-provider_2.png?fit=max&auto=format&n=oOz41askvZuXfasg&q=85&s=a0d398aa95ee3b43e05b36f2f97c1b69" data-path="images/thousandeyes-provider_2.png" />
</Frame>

4. Under `User API Tokens`, you can create OAuth Bearer Token

<Frame width="100" height="200">
  <img height="10" src="https://mintcdn.com/keep-docs/oOz41askvZuXfasg/images/thousandeyes-provider_3.png?fit=max&auto=format&n=oOz41askvZuXfasg&q=85&s=221a5ba23d2c69bfa34b41df1bffed7b" data-path="images/thousandeyes-provider_3.png" />
</Frame>

5. Copy the generated token. This will be used as the `OAuth2 Bearer Token` in the provider settings.

## Webhooks Integration

1. Open [ThousandEyes Dashboard](https://app.thousandeyes.com/dashboard) and click on `Network & App Synthetics` in the left sidebar and select `Agent Settings`.

<Frame width="100" height="200">
  <img height="10" src="https://mintcdn.com/keep-docs/oOz41askvZuXfasg/images/thousandeyes-provider_4.png?fit=max&auto=format&n=oOz41askvZuXfasg&q=85&s=9ba65a2a2c44f072b88ddca777c7cb3e" data-path="images/thousandeyes-provider_4.png" />
</Frame>

2. Go to `Notifications` under `Enterprise Agents` and click on `Notifications`.

<Frame width="100" height="200">
  <img height="10" src="https://mintcdn.com/keep-docs/oOz41askvZuXfasg/images/thousandeyes-provider_5.png?fit=max&auto=format&n=oOz41askvZuXfasg&q=85&s=6edac4434a90e60c5b66ad861db4aaf7" data-path="images/thousandeyes-provider_5.png" />
</Frame>

3. Go to `Notifications` and create new webhook notification.

<Frame width="100" height="200">
  <img height="10" src="https://mintcdn.com/keep-docs/oOz41askvZuXfasg/images/thousandeyes-provider_6.png?fit=max&auto=format&n=oOz41askvZuXfasg&q=85&s=7ee77ac1ed9b52cfef23bd536044c8b5" data-path="images/thousandeyes-provider_6.png" />
</Frame>

4. Give it a name and set the url as [https://api.keephq.dev/alerts/event/thousandeyes?api\_key=your-api-key](https://api.keephq.dev/alerts/event/thousandeyes?api_key=your-api-key)

5. Select `Auth Type` as None and `Add New Webhook`.

<Frame width="100" height="200">
  <img height="10" src="https://mintcdn.com/keep-docs/oOz41askvZuXfasg/images/thousandeyes-provider_7.png?fit=max&auto=format&n=oOz41askvZuXfasg&q=85&s=797c00246fe0a94e80521b1653277d51" data-path="images/thousandeyes-provider_7.png" />
</Frame>

6. Go to Keep dashboard and click on the profile icon in the botton left corner and click `Settings`.

<Frame width="100" height="200">
  <img height="10" src="https://mintcdn.com/keep-docs/S6DFtL8OlXzhsodk/images/keep-apikey-1.png?fit=max&auto=format&n=S6DFtL8OlXzhsodk&q=85&s=8d4dc8e4078a79209a1e236ce04a720c" data-path="images/keep-apikey-1.png" />
</Frame>

7. Select `Users and Access` tab and then select `API Keys` tab and create a new API key.

<Frame width="100" height="200">
  <img height="10" src="https://mintcdn.com/keep-docs/S6DFtL8OlXzhsodk/images/keep-apikey-2.png?fit=max&auto=format&n=S6DFtL8OlXzhsodk&q=85&s=bd6f1171332d17eaa71673b8b2140819" data-path="images/keep-apikey-2.png" />
</Frame>

8. Give name and select the role as `webhook` and click on `Create API Key`.

<Frame width="100" height="200">
  <img height="10" src="https://mintcdn.com/keep-docs/S6DFtL8OlXzhsodk/images/keep-apikey-3.png?fit=max&auto=format&n=S6DFtL8OlXzhsodk&q=85&s=c45eee0ceb6b6064a0749d5c3ebf7d5c" data-path="images/keep-apikey-3.png" />
</Frame>

9. Copy the API key and paste it in the webhook URL.

<Frame width="100" height="200">
  <img height="10" src="https://mintcdn.com/keep-docs/S6DFtL8OlXzhsodk/images/keep-apikey-4.png?fit=max&auto=format&n=S6DFtL8OlXzhsodk&q=85&s=529e2a35b9930b953e7a5b6e4d16c104" data-path="images/keep-apikey-4.png" />
</Frame>

## Useful Links

* [ThousandEyes](https://www.thousandeyes.com/)