---
metadata:
  - name: generator
    content: Diplodoc Platform v5.55.0
alternate:
  - https://yandex.com/dev/market/partner-api/doc/en/concepts/api-key.md
  - https://yandex.com/dev/market/partner-api/doc/ru/concepts/api-key.md
  - https://yandex.com/dev/market/partner-api/doc/zh/concepts/api-key.md
  - href: en/concepts/api-key.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/market/partner-api/doc/en/llms.txt

# Creation and use API-Key-tokens

To work with   Yandex. Market   via the API:

1. Create a token with access to certain groups of methods. This way, employees will be able to call only the methods they need for their work.   [What types of access are available](https://yandex.com/dev/market/partner-api/doc/en/concepts/access.md)  
2. Insert the token in the request header   to the Market  .

Only the cabinet owner and cabinet manager can create and manage tokens.   For more information about what roles are available, read [in the Help of the Market for sellers](https://yandex.ru/support2/marketplace/ru/account/permissions/roles).  

The maximum number of tokens for the cabinet — 30.

The token is valid indefinitely — it remains active until you delete it.

## Create a token {#new-token}

1. In the cabinet   the seller on the Market   click on your account icon → **Settings** and in the menu on the left, select   **APIs and modules**  .

1. In the block **Authorization tokens** Click the button **Create a new token**.

    

    ![Screenshot](../_images/concepts/api-token.png)
    


1. In the window that opens:

    1. Specify the unique name of the token.

    1. Select the access rights that you want to grant.

    1. Click the button **To create**.

    

    ![Screenshot](../_images/concepts/access.png)
    


## Edit the token {#edit-token}


{% note warning "Перед редактированием" %}


Make sure that your integration will continue to work with the modified token.


{% endnote %}


You can change access rights, as well as the name of the token. To do this:

1. In the cabinet   the seller on the Market   click on your account icon → **Settings** and in the menu on the left, select   **APIs and modules**  .

1. In the block **Authorization tokens** find the one you need, tap the three dots next to it and select **Edit**.

1. Change the required information.

1. Click **Save**.

The information will be updated within 10 minutes.

## Delete a token {#delete-token}


{% note warning "Перед удалением" %}


Make sure that your integration will continue to work without this token.


{% endnote %}


1. In the office   the seller on the Market   click on your account icon → **Settings** and in the menu on the left, select   **APIs and modules**  .

1. In the block **Authorization tokens** find the one you need, tap the three dots next to it and select **Remove**.

1. Confirm the deletion.

## Transfer the token {#use}

Insert the received token into the header `Api-Key` according to the following scheme:

```no-highlight translate=no
Api-Key: <token>
```

As a result, the title will look like this:

```no-highlight translate=no
Api-Key: ACMA:I4c4CxCSYaI41RSC2uYWP2qj3Rhhm4knMiBEga5K:151c0664
```

If the request comes without a header with a valid token,   Yandex. Market   returns an error. `401 Unauthorized`.

## It may be useful {#read-more}



* [The method of obtaining information about the transmitted authorization token](https://yandex.com/dev/market/partner-api/doc/en/reference/auth/getAuthTokenInfo.md)
* [Description of errors returned Yandex Market API](https://yandex.com/dev/market/partner-api/doc/en/concepts/error-codes.md)