Skip to main content

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 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
  1. Click Create API Key.
  2. 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.
  3. Click Create Key.
The Create API Key dialog with a key name, permissions and expiration date
  1. 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

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

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 You are now connected to Benchmark Email.