## Introduction

Sublime Security is a cloud-based email security platform. This guide shows you how to create a Sublime API key and find your Base URL to configure a Sublime Security Email Security integration.

## Prerequisites

Before you begin, ensure that you have:

- A Sublime user account with the Analyst role


## Required Permissions

A Sublime API key has the role of the user who creates it. Create the key from an account with this role:

| Role | Purpose |
|  --- | --- |
| Analyst | Read flagged message groups and their details, read the detection rules that flagged them, and list mailboxes |


## Generating API Credentials

1. Log in to your Sublime dashboard with a user account that has the Analyst role
2. In the left navigation menu, select **Automate > API**
3. Copy the *Base URL* shown on the page and store it for use in the next section
4. Select **Create API key**
5. Fill in the field titled *Name*
6. Set the API keys expiration date in the field titled *Expiration Date*
7. Select **Create**
8. Select **Copy** and store the key in a safe location
9. You have now created a Sublime API key. Proceed to the next section titled [Configuring the Integration](#configuring-the-integration)


For more information on Sublime API keys, see the Sublime [Authentication](https://docs.sublime.security/reference/authentication) docs page.

## Configuring the Integration

To configure a new Sublime Security integration, provide each of the values as defined below:

| Integration Parameter | Description |
|  --- | --- |
| API Key | The API key you copied in the steps above |
| Base URL | The *Base URL* you copied in the steps above |