## ThousandEyes integration

ThousandEyes (now part of Cisco) is a network intelligence platform that provides visibility into the performance of every network — internal, external, carrier, and Internet — that delivers your applications. Integrating ThousandEyes with Frontegg lets your application read tests, agents, alerts, and event data on behalf of your users through a User API Token (OAuth Bearer) authenticated with the v7 ThousandEyes API.

Prerequisites
- A ThousandEyes account at [app.thousandeyes.com](https://app.thousandeyes.com/)
- Permission to manage your own user profile (every user can create their own User API Token)


### Connect ThousandEyes

#### Step 1: Log in to ThousandEyes

Open [app.thousandeyes.com](https://app.thousandeyes.com/) and sign in with your ThousandEyes credentials. You may be redirected to a Cisco login page depending on your tenant.

![ThousandEyes login page](/assets/thousandeyes-1.97e8b8a030146274799588de1a709b5979a0dc9f96ea4e7037ddaceae301d6cd.1ce25488.png)

#### Step 2: Open Account Settings

In the left navigation, expand **Manage** and click **Account Settings → Users and Roles**.

![ThousandEyes Manage menu with Users and Roles highlighted](/assets/thousandeyes-2.a7038fcc078b746fc457c0ef580d49939844d87b1f91753e39986afa18a2ab60.1ce25488.png)

#### Step 3: Generate an OAuth Bearer Token

Stay on the **Profile** tab and scroll to the **User API Tokens** section. The token shown there is bound to the currently logged-in user.

- If no token exists yet, click **Generate** to create one.
- If a token already exists and you need a fresh one, click **Revoke** and then **Generate** to issue a new token.


Token is shown only once
ThousandEyes displays the token value only at the moment it is created or regenerated. Copy it immediately — once you leave the page, the value can no longer be retrieved and you will need to revoke and regenerate.

![ThousandEyes User API Tokens section with OAuth Bearer Token highlighted](/assets/thousandeyes-3.8aa1d7ffca32586ed1791f30470671c11faa5058bf46b32c5642afa5c98ef1f5.1ce25488.png)

#### Step 4: (Optional) Find your account group ID

Skip this step if your user has access to a single account group — the token routes API calls to that group automatically.

If your user belongs to multiple account groups, open the **Account Groups** tab on the same Users and Roles page to see the list of groups available to your token.

![ThousandEyes Account Groups tab](/assets/thousandeyes-4.6781f7825311a481ad44c2620528796178d07e5456186cb6b8a51907cdb211c0.1ce25488.png)

The numeric account group ID (`aid`) is not surfaced directly in the UI. To retrieve it, call the v7 API with the bearer token from Step 3:


```bash
curl -H "Authorization: Bearer YOUR_USER_API_TOKEN" \
  https://api.thousandeyes.com/v7/account-groups
```

The response lists every account group available to your token along with its `aid`. Note the `aid` of the group you want Frontegg to operate against.

### Configure the Frontegg portal

Once you have your **User API Token** (and, if applicable, the **Account Group ID**), enter them in the integration configuration page of the Frontegg portal:

1. Open the **Frontegg portal** and navigate to your environment's **Integrations** section.
2. Find **ThousandEyes** and open its configuration page.
3. Paste the User API Token into the **API Key** field.
4. If your user has access to multiple account groups, paste the numeric ID into the **Account Group ID** field. Otherwise, leave it empty.
5. Click **Save**.


Keep your token secure
A User API Token grants access to every account group the issuing user can reach. Treat it as a password, never commit it to version control, and rotate it via **Revoke → Generate** if you suspect it has been exposed.

### Additional resources

- [ThousandEyes API v7 reference](https://developer.cisco.com/docs/thousandeyes/)
- [ThousandEyes authentication guide](https://developer.cisco.com/docs/thousandeyes/authentication/)
- [Account group context](https://developer.cisco.com/docs/thousandeyes/account-group-context/)
- [ThousandEyes documentation](https://docs.thousandeyes.com/product-documentation/api)
- [How to get your Redirect URL](/agen-for-work/connectors/redirect-url)