> ## Documentation Index
> Fetch the complete documentation index at: https://nango-wari-integration-config-credentials-api.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-wari-integration-config-credentials-api/5Bzz8u-Zenu6owO9/api-integrations/huntress/huntress_navigation_api_credentials.png?fit=max&auto=format&n=5Bzz8u-Zenu6owO9&q=85&s=fec0ba7f4c0577b4fd3401bdad7f16d5" 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-wari-integration-config-credentials-api/5Bzz8u-Zenu6owO9/api-integrations/huntress/huntress_user_api_credentials.png?fit=max&auto=format&n=5Bzz8u-Zenu6owO9&q=85&s=f28747e5178614add5699f3684a17130" 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-wari-integration-config-credentials-api/5Bzz8u-Zenu6owO9/api-integrations/huntress/huntress_create_user_api_credential.png?fit=max&auto=format&n=5Bzz8u-Zenu6owO9&q=85&s=f20230a6af20f5b2e6380159c8e25b67" 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 is no longer available after you navigate away from this page.

<img src="https://mintcdn.com/nango-wari-integration-config-credentials-api/5Bzz8u-Zenu6owO9/api-integrations/huntress/huntress_user_api_credential_created_redacted.png?fit=max&auto=format&n=5Bzz8u-Zenu6owO9&q=85&s=4093d65ae91453b1687283b3a80744a0" 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-wari-integration-config-credentials-api/5Bzz8u-Zenu6owO9/api-integrations/huntress/huntress_connect_ui.png?fit=max&auto=format&n=5Bzz8u-Zenu6owO9&q=85&s=2ed68f0dde1a5b19a0cb8185332809f1" 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.
