> For the complete documentation index, see [llms.txt](https://docs.360dialog.com/partner/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.360dialog.com/partner/onboarding/integration-best-practices/api-key-authentication-for-the-partner-api.md).

# API Key Authentication for the Partner API

### How to Create, View, and Delete API Keys

{% stepper %}
{% step %}
**Log in** to your [Partner Dashboard](https://app.360dialog.com/).
{% endstep %}

{% step %}
Open **"Integration"** tab
{% endstep %}

{% step %}
Scroll down to the **“Partner API Keys”** section:

<figure><img src="https://2248475362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuyAl2S0lSHJaNDXJHo7A%2Fuploads%2FXcLLklBnXPp79SsXUzCK%2F2026-09-17_14-54-55-snaplight-805.png?alt=media&amp;token=9197718e-c83f-4305-be3c-03c2bfa54aa7" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
To **generate a new key**:

Click “**Generate API Key**”

Add a name (e.g., “Prod Server”)

Complete the OTP

Copy the key and store it securely — this is the only time you’ll see it.

Use different keys for different environments or systems to isolate access and simplify management.
{% endstep %}

{% step %}
To delete a key, simply click the trash icon next to the key name. The key is immediately revoked.
{% endstep %}
{% endstepper %}

To start using an API key, add the `x-api-key` authorization header to requests:

```markdown
curl -X GET "https://hub.360Dialog.io/api/v2/..." \
  -H "x-api-key: YOUR_API_KEY_HERE"
```

**Outdated Authentication Method - Bearer Token**

Starting from September 28, 2026, the `x-api-key` header is the only supported authentication method. The Bearer token approach is deprecated. All endpoints and functionality remain unchanged.

Bearer Token Limitations

The Bearer token authentication had several structural limitations:

* Single Token Access – Only one token was available per account, preventing the separation of environments or integrations.
* Lack of Granular Control – Managing different keys for distinct use cases was not supported.
* Security Risks – If a Bearer token was compromised, revoking it disrupted all access across the account.

### FAQ's

#### Can I have multiple API keys?

Yes, you can generate multiple keys and revoke them individually.

#### What happens if I delete an API key?

Any API requests using that key will stop working immediately. Make sure to update your integrations before deleting keys.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.360dialog.com/partner/onboarding/integration-best-practices/api-key-authentication-for-the-partner-api.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.