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

# Benchmark Email - How do I link my account?

## Overview

To authenticate with Benchmark Email, you need:

1. **API Key** — a Benchmark Email API key.
2. **API Host** — the host of your account's API base URL, for example `api-us-west-2-a.benchmarkemail.io`.

This guide will show you how to get them.

### Prerequisites

* A Benchmark Email account. API keys are available on every plan, including Free.
* The **Owner** role on the account. Only Owners can create and manage API keys.

### Step 1: Create an API key

1. Log in to [Benchmark Email](https://app.benchmarkemail.io) with an Owner account.
2. Click **Integrations** in the left sidebar, then open the **API Keys** tab.

![The API Keys tab under Integrations in Benchmark Email](https://mintcdn.com/nango/GspaznYhqnV1dN2a/api-integrations/benchmark-email/integrations_api_keys_tab.png?fit=max\&auto=format\&n=GspaznYhqnV1dN2a\&q=85\&s=2c06c907cc1c942193eedcdbfb8b3d0f)

3. Click **Create API Key**.
4. Enter a **Key Name**, choose **Read** or **Read & Write** under **Permissions** for each resource your integration needs, and optionally set an **Expiration Date**. Without one, the key never expires.
5. Click **Create Key**.

![The Create API Key dialog with a key name, permissions and expiration date](https://mintcdn.com/nango/GspaznYhqnV1dN2a/api-integrations/benchmark-email/create_api_key_dialog.png?fit=max\&auto=format\&n=GspaznYhqnV1dN2a\&q=85\&s=8feadc22c25d2fd9c449c1a54939d4c7)

6. Copy the API key now. It is shown only once, so store it somewhere safe, then click **Done**.

![The API Key dialog showing the new key with a Copy button](https://mintcdn.com/nango/GspaznYhqnV1dN2a/api-integrations/benchmark-email/api_key_created.png?fit=max\&auto=format\&n=GspaznYhqnV1dN2a\&q=85\&s=a731ed5b0e2f9a1cb260fb16fb750993)

### Step 2: Copy your API host

1. On the same **API Keys** tab, find the **Base URL** under **My API Keys**.
2. Copy its host, without `https://`. For example, for `https://api-us-west-2-a.benchmarkemail.io`, the API host is `api-us-west-2-a.benchmarkemail.io`.

![The Base URL field under the API keys list in Benchmark Email](https://mintcdn.com/nango/GspaznYhqnV1dN2a/api-integrations/benchmark-email/api_base_url.png?fit=max\&auto=format\&n=GspaznYhqnV1dN2a\&q=85\&s=0c990a4553c11964e1589af9c2dfc83b)

### Step 3: Enter your credentials in the Connect UI

1. Open the form where you need to authenticate with Benchmark Email.
2. Enter your **API Host** and **API Key** in the designated fields.
3. Submit the form, and you should be successfully authenticated.

![The Benchmark Email connection form in the Connect UI](https://mintcdn.com/nango/GspaznYhqnV1dN2a/api-integrations/benchmark-email/form.png?fit=max\&auto=format\&n=GspaznYhqnV1dN2a\&q=85\&s=9130c2c0d4a411594612e00977f48f15)

You are now connected to Benchmark Email.


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