> ## Documentation Index
> Fetch the complete documentation index at: https://nango-marcin-get-deployments-docs.mintlify.site/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**.

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/pMmrQEHxzzVBg1I3/api-integrations/huntress/huntress_navigation_api_credentials.png?fit=max&auto=format&n=pMmrQEHxzzVBg1I3&q=85&s=03f1dc026d41849667357b25418139d5" style={{maxWidth: "320px" }} width="392" height="1330" data-path="api-integrations/huntress/huntress_navigation_api_credentials.png" />

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

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/pMmrQEHxzzVBg1I3/api-integrations/huntress/huntress_user_api_credentials.png?fit=max&auto=format&n=pMmrQEHxzzVBg1I3&q=85&s=a9b0d0162029ae4d4bedef090f8ebfa8" width="3242" height="628" data-path="api-integrations/huntress/huntress_user_api_credentials.png" />

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

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/pMmrQEHxzzVBg1I3/api-integrations/huntress/huntress_create_user_api_credential.png?fit=max&auto=format&n=pMmrQEHxzzVBg1I3&q=85&s=4362bc0b3cf84dcb928bf6065ac0b295" style={{maxWidth: "520px" }} width="1022" height="698" data-path="api-integrations/huntress/huntress_create_user_api_credential.png" />

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

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/pMmrQEHxzzVBg1I3/api-integrations/huntress/huntress_user_api_credential_created_redacted.png?fit=max&auto=format&n=pMmrQEHxzzVBg1I3&q=85&s=1f6af22b434997d76e1b5a6845995ce3" style={{maxWidth: "520px" }} width="1020" height="986" data-path="api-integrations/huntress/huntress_user_api_credential_created_redacted.png" />

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

<img src="https://mintcdn.com/nango-marcin-get-deployments-docs/pMmrQEHxzzVBg1I3/api-integrations/huntress/huntress_connect_ui.png?fit=max&auto=format&n=pMmrQEHxzzVBg1I3&q=85&s=8cfa865b475ff66b273c57b5849906ac" style={{maxWidth: "520px" }} width="1150" height="1576" data-path="api-integrations/huntress/huntress_connect_ui.png" />

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.