> For the complete documentation index, see [llms.txt](https://docs.360dialog.com/docs/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/docs/hub/api-key.md).

# API Keys

API keys are necessary for using the 360Dialog API. API keys are generated per phone number.

## **Who can generate an API key?**

The ability to generate an API key depends on the phone number's payment method and the Partner's access to that number.

**360Dialog direct clients**

* Can manage their API Key in the 360Dialog Hub at anytime

**Partner´s clients**

* Can manage their API Key on their own just in case the payment method is "direct payment" and the Partner Access is removed 

{% hint style="info" %}
Your integration partner is responsible for creating the API Key. If you need to reclaim your API key, please contact your Integration Partner. 
{% endhint %}

## **How to Generate an API Key**

After successful onboarding, the "Generate API Key" option will be enabled, depending on the onboarding type.

For safety reasons, the API key will show up only once. Make sure to store the key in a safe place before closing the window.

{% hint style="warning" %}
Generating a new API key will revoke all existing API keys.
{% endhint %}

{% stepper %}
{% step %}
Open [Client Hub](https://app.360dialog.com/).
{% endstep %}

{% step %}
In the Channels section, click the channel for which the API key needs to be created. 

<figure><img src="/files/WBxZb12E6i8RQO13UzXB" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Go to the API Settings section and click the three dots, then click "Generate new API Key".

<figure><img src="/files/i4C8mTgiAIRmKpMDqUIq" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Type GENERATE to confirm the API Key creation, then click "Generate new API key".&#x20;

<figure><img src="/files/OnZ6CKYE1ezY5P4PPpMZ" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## **Partner-generated API keys**

During onboarding, partner access is granted upon acceptance of the terms.&#x20;

Once the number is connected, the integration partner is responsible for creating the API Key, and the client can´t do this. The client will see the note `Managed by partner`.&#x20;

<figure><img src="/files/gocpMWiIuaAVhC75jzAR" alt=""><figcaption></figcaption></figure>

### How to check & manage Partner Access <a href="#how-to-check-if-you-have-permission" id="how-to-check-if-you-have-permission"></a>

Partner Access can be checked in the 360dialog Hub → Channels → Exact Channel → API Settings.&#x20;

<figure><img src="/files/KEAhbrJfDBdqXLKemuCp" alt=""><figcaption></figcaption></figure>

Clients can toggle the Partner Access at anytime. Please be aware that once the Partner Access is removed, the integration may not work as expected.&#x20;


---

# 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/docs/hub/api-key.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.