---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.2
alternate:
  - https://appmetrica.yandex.by/docs/en/mobile-api/management/applications/createapplication.md
  - https://appmetrica.yandex.by/docs/ru/mobile-api/management/applications/createapplication.md
  - href: en/mobile-api/management/applications/createapplication.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://appmetrica.yandex.by/docs/en/llms.txt

# Create app

Adds an app to AppMetrica.

## Request format {#request-format}

```
POST https://api.appmetrica.yandex.com/management/v1/applications
```

### Request body {#request-body}

```json translate=no
{
  "application": {
    "name": "string",
    "category": int,
    "time_zone_name": "string",
    "hide_address": bool,
    "gdpr_agreement_accepted": bool
  }
}
```

#|
|| `name` | App name ||
|| `category` | ID of the app category.

To get a list of all app categories, use the [Category list](https://appmetrica.yandex.by/docs/en/mobile-api/management/applications/get-categories.md) method. ||
|| `time_zone_name` | Time zone for statistics ||
|| `hide_address` | The status indicating if the collecting complete IP addresses of users from the EU is enabled.

Possible values:
- `true` — Enabled.
- `false` — Disabled. ||
   || `gdpr_agreement_accepted` | Acceptance status of the [General Data Protection Regulation compliance](https://yandex.ru/legal/metrica_agreement/).

Possible values:
- `true` — The compliance is accepted.
- `false` — The compliance is declined. ||
   |#

## Response format {#response-body}

```json translate=no
{
  "application": {
    "name": "string",
    "time_zone_name": "string",
    "hide_address": bool,
    "gdpr_agreement_accepted": bool,
    "category": int,
    "use_universal_links": bool,
    "id": int,
    "uid": int,
    "owner_login": "string",
    "api_key128": "string",
    "import_token": "string",
    "permission": "string",
    "time_zone_offset": int,
    "create_date": "YYYY-MM-DD"
  }
}
```

#|
|| `name` | App name ||
|| `time_zone_name` | Time zone for statistics ||
|| `hide_address` | The status indicating if the collecting complete IP addresses of users from the EU is enabled.

Possible values:
- `true` — Enabled.
- `false` — Disabled. ||
   || `gdpr_agreement_accepted` | Acceptance status of the [General Data Protection Regulation compliance](https://yandex.ru/legal/metrica_agreement/).

Possible values:
- `true` — The compliance is accepted.
- `false` — The compliance is declined. ||
   || `category` | ID of the app category.

To get a list of all app categories, use the [Category list](https://appmetrica.yandex.by/docs/en/mobile-api/management/applications/get-categories.md) method. ||
|| `use_universal_links` | Universal link usage status.

Possible values:
- `true` — Use universal link is enabled.
- `false` — Use universal link is disabled. ||
   || `id` | App ID ||
   || `uid` | ID of the user who added the app. ||
   || `owner_login` | Login of the app owner. ||
   || `api_key128` | API key. ||
   || `import_token` | Post API key. ||
   || `permission` | Access rights.

Possible values:

- `view`: Read only.
- `edit`: Read/Edit.
- `agency_view`: Agency read only.
- `agency_edit`: Agency read/edit.
- `own`: App owner.

For more information, see [Managing app access](https://appmetrica.yandex.by/docs/en/common/access.md). ||
|| `time_zone_offset` | The time zone offset relative to UTC in seconds. ||
|| `create_date` | Date the app was added. ||
|#

## Example {#example}

{% list tabs %}

- cURL

   ```bash translate=no
   curl -X POST \
     'https://api.appmetrica.yandex.com/management/v1/applications' \
     -H 'Content-Type: application/json' \
     -H 'Authorization: OAuth <your_token>' \
     -d '{
       "application": {
           "name": "string",
           "category": 85,
           "time_zone_name": "Asia/Yekaterinburg",
           "hide_address": true,
           "gdpr_agreement_accepted": true
       }
   }'
   ```

   where `<your_token>` is an OAuth token that can be obtained using [instructions](https://appmetrica.yandex.by/docs/en/mobile-api/intro/authorization.md#get-oauth-token).

- HTTP

   ```http translate=no
   POST /management/v1/applications HTTP/1.1
   Host: api.appmetrica.yandex.com
   Content-Type: application/json
   Authorization: OAuth <your_token>

   {
     "application": {
       "name": "string",
       "category": 85,
       "time_zone_name": "Asia/Yekaterinburg",
       "hide_address": true,
       "gdpr_agreement_accepted": true
     }
   }
   ```

   where `<your_token>` is an OAuth token that can be obtained using [instructions](https://appmetrica.yandex.by/docs/en/mobile-api/intro/authorization.md#get-oauth-token).

{% endlist %}

<!-- source: en/_includes/feedback-button-3.md -->
If you didn't find the answer you were looking for, you can use the feedback form to submit your question. Please describe the problem in as much detail as possible. Attach a screenshot if possible.

<a href="../../../troubleshooting/feedback-new">
  <span class="button">Contact support</span>
</a>

<a href="../../../troubleshooting/feedback-docs">
  <span class="button">Suggest an improvement for documentation</span>
</a>
<!-- endsource: en/_includes/feedback-button-3.md -->