> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect DeepL with API Key – StackOne Hub

> Link a DeepL account in the StackOne Hub using API Key. End-user guide to authorize the integration and start using DeepL actions.

## Generating an API key

A DeepL API key authenticates every request StackOne sends to the DeepL API.

**1. Sign in to DeepL**

Sign in to your [DeepL API account](https://auth.deepl.com/login).

![DeepL sign-in](https://mintcdn.com/stackone-60/4QmROGihNURd0Mxs/connectors/deepl/images/custom-config-sign-in.png?fit=max\&auto=format\&n=4QmROGihNURd0Mxs\&q=85\&s=fdcb948cd82fb698c6d50ed667d2247f)

**2. Open your account settings**

In the sidebar at the bottom-right, click **Account**.

![Account menu](https://mintcdn.com/stackone-60/4QmROGihNURd0Mxs/connectors/deepl/images/custom-config-home.png?fit=max\&auto=format\&n=4QmROGihNURd0Mxs\&q=85\&s=b9faa171ab733684615e2b143eafe910)

**3. Open API Keys & Limits**

On the **Your account** page, click the **API Keys & Limits** tab.

![Account tabs](https://mintcdn.com/stackone-60/4QmROGihNURd0Mxs/connectors/deepl/images/custom-config-account.png?fit=max\&auto=format\&n=4QmROGihNURd0Mxs\&q=85\&s=a38209f3db30444ebc1b7bad533fe1c3)

**4. Create and copy a key**

On the **API keys** subtab, click **Create key**, or use an existing key from the table.

<ul>
  <li>Leave the permissions unchanged so the **Permissions** column shows **Unrestricted**. A key with **Custom permissions** returns `403 Forbidden` for any endpoint outside its scopes.</li>
  <li>Click the copy icon next to the key in the **API key** column.</li>
  <li>Paste it into the **API Key** field in StackOne Hub.</li>
  <li>DeepL API Free keys end in `:fx`.</li>
</ul>

![API keys table](https://mintcdn.com/stackone-60/4QmROGihNURd0Mxs/connectors/deepl/images/custom-config-api-keys.png?fit=max\&auto=format\&n=4QmROGihNURd0Mxs\&q=85\&s=e06a289cb2f8f928396fd2fd6de49000)

## Select your API plan

The **API Plan** field tells StackOne which DeepL host to call. Free and Pro keys work only on their own host.

<ul>
  <li>Select **DeepL API Free (api-free.deepl.com)** for a key that ends in `:fx`.</li>
  <li>Otherwise, select **DeepL API Pro (api.deepl.com)**.</li>
</ul>

## Linking the Account from the Hub

**1. Navigate to the Hub**

Use one of the three [Linking Account Methods](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md) to access the Hub.

**2. Fill out the fields**

Fill out the following fields using details from your provider:

<ul>
  <li>**API Key**</li>
  <li>**API Plan**</li>
</ul>

**3. Connect**

<ul>
  <li>Click **Connect**</li>
  <li>If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider's authorization flow.</li>
  <li>Once authorization is successful, you will see a confirmation popup</li>
</ul>

If the account linking is successful, you will see the newly linked account on your [Accounts](https://app.stackone.com/accounts) page.


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