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

# Elasticsearch - How do I link my account?

## Overview

To authenticate with Elasticsearch, you need:

1. **Elasticsearch Endpoint** — the URL of your Elasticsearch project, deployment or cluster.
2. **API Key** — an Elasticsearch API key in the Encoded format.

This guide will show you how to find and create them.

### Prerequisites

* An Elasticsearch cluster, or an Elastic Cloud project or deployment. You can [sign up for Elastic Cloud](https://www.elastic.co/cloud/elasticsearch-service/signup) with a free trial, no credit card required.

### Step 1: Find your Elasticsearch endpoint

1. Sign in to the [Elastic Cloud Console](https://cloud.elastic.co) and select **Open** on your project or deployment to open Kibana.
2. Open the **Help** menu at the top right and select **Connection details**.

![Kibana Help menu with Connection details highlighted](https://mintcdn.com/nango/pTAYoR_gRtafki6K/api-integrations/elasticsearch/help_menu_connection_details.png?fit=max\&auto=format\&n=pTAYoR_gRtafki6K\&q=85\&s=e519870906d9b89de931b96787943305)

3. On the **Endpoints** tab, copy the **Elasticsearch endpoint**, for example `https://my-deployment-a1b2c3.es.us-central1.gcp.elastic-cloud.com`.

On a self-managed cluster, your endpoint takes the form `<scheme>://<host>:<port>`. Enter it without a trailing slash.

### Step 2: Create an API key

1. In the **Connection details** panel, select the **API key** tab. To create a key with your own privileges, enter a name and select **Create API key**. To restrict what the key can do, select **Manage API keys** instead.

![Kibana Connection details panel on the API key tab with the API key name field, Manage API keys link and Create API key button](https://mintcdn.com/nango/pTAYoR_gRtafki6K/api-integrations/elasticsearch/connection_details_api_key_tab.png?fit=max\&auto=format\&n=pTAYoR_gRtafki6K\&q=85\&s=11fdda74f823d1f9cc1c00bec72ab579)

2. On the **API keys** page, select **Create API key** and enter a name. Turn on **Control security privileges** and set the privileges your integration needs. For read-only access, select the **Read-only** boilerplate. Then select **Create API key**.

![Kibana Create API key flyout with Control security privileges turned on and a read-only role descriptor](https://mintcdn.com/nango/pTAYoR_gRtafki6K/api-integrations/elasticsearch/create_api_key_form.png?fit=max\&auto=format\&n=pTAYoR_gRtafki6K\&q=85\&s=52bf1fc046b18b7172c26af4b8e9673c)

3. Keep the **Encoded** format selected and copy the key. It isn't available after you close the panel.

![Kibana API keys page with the created key, the Encoded format selected and the copy button](https://mintcdn.com/nango/pTAYoR_gRtafki6K/api-integrations/elasticsearch/api_key_created.png?fit=max\&auto=format\&n=pTAYoR_gRtafki6K\&q=85\&s=12f0ad3b8bca713bb49c6ffa518e261a)

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

1. Open the form where you need to authenticate with Elasticsearch.
2. Enter your **Elasticsearch Endpoint** and your **API Key**.
3. Submit the form. Nango checks the key against your endpoint, and you should be successfully authenticated.

![Elasticsearch Connect UI form with the Elasticsearch Endpoint and API Key fields](https://mintcdn.com/nango/pTAYoR_gRtafki6K/api-integrations/elasticsearch/form.png?fit=max\&auto=format\&n=pTAYoR_gRtafki6K\&q=85\&s=2d2c62a6e0cf648a152dadbebac8b5d7)

You are now connected to Elasticsearch.


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