Creating access keys

If this is your first subscription, the first API key is created automatically.

To create an additional key in a subscription:

1. Purchase a subscription.

2. Go to the API Keys tab and click Create API Key.

3. Enter the key name and click Create.

4. If you plan to use the key for the mobile SDK:

   1. Enable the Use for SDK option.

   2. (Optional) To specify the App ID for which the key will be used, enable the App ID option. Specifying the App ID is required only for SDK versions earlier than 13.3.0 or if you plan to work with offline data. App ID requirements:

      For iOS

      You can use Latin letters (A–Z, a–z), digits (0–9), dots (.) to separate segments, and hyphens (-).

      For more information, see the official documentation.

      For Android and Flutter

      • You can use Latin letters (A–Z, a–z), digits (0–9), dots (.) to separate segments, and underscores (_).
      • The App ID must contain at least two segments separated by dots (e.g., com.example.app). Each segment must start with a letter.

      For more information, see the official documentation.

      warning

      If the key has an App ID specified, you can only use this key for working with the mobile SDK. To work with the 2GIS API directly (via HTTP requests), create a separate key.

   3. Click Save and download key.

5. Go to the documentation of the product you are interested in to start working with the API.

You can use the created API key to work with all services included in the subscription.

For more information about managing keys, see the Access key management instruction. You can also view statistics of limit consumption and request distribution.