---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.ru/dev/api360/doc/ru/directory/post-office.md
  - href: ru/directory/post-office.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: docs/dev/api360/concepts/gw/directory/post-office.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/api360/doc/ru/llms.txt

# Создать офис организации

Создает новый офис организации.

{% note info %}

Чтобы выполнить запрос, приложению требуется разрешение `directory:write_offices` — просмотр и изменение данных офисов.

{% endnote %}

## Запрос {#request}

##POST## `https://cloud-api.yandex.net/v1/directory/organizations/{org_id}/offices`

### Path-параметры {#path-parameters}

#|
|| **Имя параметра** | **Тип** | **Описание** ||
|| org_id **\*** | integer | Идентификатор организации. ||
|#

### Заголовки {#headers}

```json
Authorization: OAuth <токен>
Content-Type: application/json
```

### Тело {#body}

#|
|| **Имя параметра** | **Тип** | **Описание** ||
|| name | string | Название офиса. ||
|| address | string | Адрес офиса. ||
|| city | string | Город, в котором расположен офис. ||
|#

### Пример {#example}

{% cut "Пример запроса" %}

```bash
curl --request POST \
  --url https://cloud-api.yandex.net/v1/directory/organizations/167730/offices \
  --header 'authorization: OAuth <токен>' \
  --header 'content-type: application/json' \
  --data '{
  "name": "Головной офис",
  "address": "115088, ул. Янтарная, 12, стр. 3",
  "city": "Соснополь"
}'
```

{% endcut %}

## Ответ {#response}

### Успешный ответ {#successful}

Результатом корректного запроса является ответ с кодом 201 и телом в формате JSON, где содержится идентификатор созданного офиса.

`201 Created` — офис успешно создан.

#|
|| **Поле** | **Тип** | **Описание** ||
|| id | string | Идентификатор созданного офиса. ||
|#

#### Пример {#response-example}

{% cut "Пример ответа" %}

```json
{
  "id": "c3e9a742-16bd-4f58-a201-8d4f7b1e2c93"
}
```

{% endcut %}

### Неуспешный ответ {#unsuccessful}

Ошибки могут быть со следующими HTTP-статусами:

- `400 Bad Request` — параметры запроса не заданы или заданы неверно;
- `401 Unauthorized` — пользователь не авторизован;
- `403 Forbidden` — у пользователя или приложения нет прав на создание офиса;
- `404 Not Found` — запрашиваемая организация не найдена;
- `409 Conflict` — достигнуто максимальное количество офисов в организации;
- `415 Unsupported Media Type` — ошибка в теле запроса;
- `422 Unprocessable Entity` — переданы некорректные данные (например, неверное значение поля);
- `500 Internal Server Error` — ошибка произошла на стороне сервера (в этом случае попробуйте повторно отправить запрос через некоторое время).