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

# Huntress - How do I link my account?

## Overview

To authenticate with Huntress, you will need:

1. **API Key** - A Huntress API key that starts with `hk_`.
2. **API Secret** - A Huntress API secret that starts with `hs_`.

Huntress recommends user API keys. User API keys mirror the permissions of the user who generates them, while the older account API key is deprecated and read-only.

Huntress also publishes a [screenshot walkthrough for generating API keys](https://support.huntress.io/hc/en-us/articles/4416826761235-Generating-API-Keys).

### Prerequisites

* You must have access to the Huntress console.
* Your Huntress user must have the permissions required for the API resources you want to access.

### Instructions

#### Step 1: Generate user API credentials

1. Log in to the [Huntress Platform](https://huntress.io) as a user with Admin privileges.
2. Open the hamburger menu in the upper-right corner and select **API Credentials**.

![](https://mintcdn.com/nango/MFBToUtgyucci5lG/api-integrations/huntress/huntress_navigation_api_credentials.png?fit=max\&auto=format\&n=MFBToUtgyucci5lG\&q=85\&s=02fe9cb42be468d3c910ef8954307bf4)

3. In the **User API Credentials** section, click **Add**.

![](https://mintcdn.com/nango/MFBToUtgyucci5lG/api-integrations/huntress/huntress_user_api_credentials.png?fit=max\&auto=format\&n=MFBToUtgyucci5lG\&q=85\&s=1ab6b7b674844085a3a97b34840a1668)

4. Select the user that should own the credential, add any notes, and click **Create**.

![](https://mintcdn.com/nango/MFBToUtgyucci5lG/api-integrations/huntress/huntress_create_user_api_credential.png?fit=max\&auto=format\&n=MFBToUtgyucci5lG\&q=85\&s=b58fc618ceccf177fe068d95eeee88cd)

5. Copy the generated **API Key** and **API Secret** and store them securely. The API Secret is no longer available after you navigate away from this page.

![](https://mintcdn.com/nango/MFBToUtgyucci5lG/api-integrations/huntress/huntress_user_api_credential_created_redacted.png?fit=max\&auto=format\&n=MFBToUtgyucci5lG\&q=85\&s=a4638d8942a7e4900b26563c1e8faffe)

#### Step 2: Enter credentials in the Connect UI

Once you have your **API Key** and **API Secret**:

1. Open the form where you need to authenticate with Huntress.

![](https://mintcdn.com/nango/MFBToUtgyucci5lG/api-integrations/huntress/huntress_connect_ui.png?fit=max\&auto=format\&n=MFBToUtgyucci5lG\&q=85\&s=9df776a54b223a15adbad1a40208a893)

2. Enter your **API Key** in the **API Key** field.
3. Enter your **API Secret** in the **API Secret** field.
4. Submit the form, and you should be successfully authenticated.

You are now connected to Huntress.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.