---
title: "Installs a local shared application"
method: POST
path: "/rest.application.local.install"
tags: ["rest"]
---

# Installs a local shared application

`POST /rest.application.local.install`

Request example:
		{
			"title": "Test application",
			"handlerUrl": "https://example.com",
			"scopes": ["crm"],
			"mobile": false,
			"menuTitles": {
				"en": "Test application"
			}
		}
		If `menuTitles` is omitted, the application is installed as API-only: 
		it is not shown in the Bitrix24 interface, and its only way to access the portal is through the REST API, 
		but it can still add embeddings.

## Request body

- object
  - `title` string, required
  - `handlerUrl` string, required
  - `scopes` unknown[], required
    - unknown
  - `mobile` boolean, required
  - `menuTitles` unknown[], required
    - unknown
  - `clientId` string
  - `applicationToken` string
  - `attributes` unknown[], required
    - unknown
  - `select` string[]

## Response `200`

Success response

- object
  - `result` object
    - `item` BitrixRestAppdto
      - `id` integer
      - `clientId` string
      - `clientSecret` string
      - `applicationToken` string
      - `scopes` unknown[]
        - unknown
      - `title` string
      - `url` string
      - `urlInstall` string
      - `urlSettings` string
      - `mobile` boolean
      - `version` string
      - `active` boolean
      - `installed` boolean
      - `dateCreate` string
      - `dateInstall` string
      - `attributes` unknown[]
        - unknown
    - `oauthToken` BitrixRestOauthtokendto
      - `accessToken` string
      - `refreshToken` string
      - `expiresIn` integer
      - `serverEndpoint` string

---

[API](https://skmtc.net/bitrix24/apis/bitrix24-rest-v3-api.md) · [All operations](https://skmtc.net/bitrix24/apis/bitrix24-rest-v3-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitrix24/bitrix24-rest-v3-api/versions/3660cc6bfaf5/schema)