---
metadata:
  - name: generator
    content: Diplodoc Platform v5.44.0
alternate:
  - https://yandex.ru/dev/webmaster/doc/en/reference/hosts-add-site.md
  - https://yandex.ru/dev/webmaster/doc/ru/reference/hosts-add-site.md
keywords:
  - с
  - п
  - и
  - о
  - к
  - ' '
  - а
  - й
  - т
  - в
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/webmaster/doc/ru/llms.txt


# Добавление сайта

Добавляет сайт в список сайтов пользователя.

## Формат запроса {#request-format}

```
POST https://api.webmaster.yandex.net/v4/user/{[user-id](*user-id)}/hosts
```

#|
||
`user-id`
|
    
<!-- source: ru/_includes/popup/user-id.md -->
Тип: `int64`. ID пользователя. Необходим для вызова любых ресурсов API Яндекс Вебмастера. Чтобы получить его, используйте метод [GET /v4/user](https://yandex.ru/dev/webmaster/doc/ru/reference/user.md).
<!-- endsource: ru/_includes/popup/user-id.md -->
    
||
|#


В теле запроса укажите имя нового сайта, а также требуемый тип данных в заголовке `Content-type` (`application/json` или `application/xml`).

### Пример


{% list tabs %}

- JSON

  
  ```javascript
  {
    "host_url": "http://example.com"
  }
  ```
  

- XML

  
  ```xml
  <Data>
      <[host_url](*host_url)>http://example.com</host_url>
  </Data>
  ```

{% endlist %}


#|

||
**Параметр**
|
**Описание**
||
||

`host_url`
|
<!-- source: ru/_includes/reference/hosts-add-site/host_url/popup.md -->
URI добавляемого сайта.
<!-- endsource: ru/_includes/reference/hosts-add-site/host_url/popup.md -->
||
|#

## Формат ответа {#response-format}
### Пример


{% list tabs %}

- JSON

  
  ```javascript
  {
    "host_id": "http:example.com:80"
  }
  ```
  

- XML

  
  ```xml
  <Data>
      <[host_id](*host_id3)>http:example.com:80</host_id>
  </Data>
  ```

{% endlist %}

#|
||
**Параметр**
|
**Обязательный**
|
**Тип**
|
**Описание**
||
||
`host_id`
|
<!-- source: ru/_includes/reference/hosts-add-site/host_id/req.md -->
Да
<!-- endsource: ru/_includes/reference/hosts-add-site/host_id/req.md -->
|
<!-- source: ru/_includes/reference/hosts-add-site/host_id/type.md -->
`host id` (`string`)
<!-- endsource: ru/_includes/reference/hosts-add-site/host_id/type.md -->
|
<!-- source: ru/_includes/reference/hosts-add-site/host_id/desc.md -->
ID добавленного сайта.
<!-- endsource: ru/_includes/reference/hosts-add-site/host_id/desc.md -->
||
|#


## Коды ответа {#errors}


Чтобы посмотреть структуру ответа подробнее, нажмите на причину.

#|
|| **Код** | **Причина** | **Описание** ||
|| 201 | CREATED | Сайт добавлен в список пользователя. ||
|| 403 | [HOSTS_LIMIT_EXCEEDED](https://yandex.ru/dev/webmaster/doc/ru/reference/errors.md#hosts-limit-exceeded) | Превышен лимит количества сайтов в списке сайтов пользователя (текущий лимит — 1703).

{% list tabs %}

- JSON

  
  ```json
  {
   "error_code": "HOSTS_LIMIT_EXCEEDED",
   "limit": 1,
   "error_message": "explicit error message"
  }
  ```
  

- XML

  
  ```xml
  <Data>
    <[error_code](*error_code)>HOSTS_LIMIT_EXCEEDED</error_code>
     <[limit](*limit)>1</limit>
     <[error_message](*error_message)>explicit error message</error_message>
  </Data>
  ```

{% endlist %}
 ||
|| 403 | [INVALID_USER_ID](https://yandex.ru/dev/webmaster/doc/ru/reference/errors.md#invalid-user-id) | ID пользователя, выдавшего токен, отличается от указанного в запросе. В примерах ниже `{user_id}` указан правильный `uid` владельца OAuth-токена.

{% list tabs %}

- JSON

  
  ```json
  {
    "error_code": "INVALID_USER_ID",
    "available_user_id": 1,
    "error_message": "Invalid user id. {user_id} should be used."
  }
  ```
  

- XML

  
  ```xml
  <Data>
      <[error_code](*error_code)>INVALID_USER_ID</error_code>
      <[available_user_id](*available_user_id)>1</available_user_id>
      <[error_message](*error_message)>Invalid user id. {user_id} should be used.</error_message>
  </Data>
  ```

{% endlist %}
 ||
|| 409 | [HOST_ALREADY_ADDED](https://yandex.ru/dev/webmaster/doc/ru/reference/errors.md#host-already-added) | Сайт с таким именем уже добавлен в список сайтов пользователя.

{% list tabs %}

- JSON

  
  ```json
  {
    "error_code": "HOST_ALREADY_ADDED",
    "host_id": "http:ya.ru:80",
    "verified": false,
    "error_message": "some string"
  }
  ```
  

- XML

  
  ```xml
  <Data>
    <[error_code](*error_code)>HOST_ALREADY_ADDED</error_code> 
    <[host_id](*host_id2)>http:ya.ru:80</host_id> 
    <[verified](*verified)>false</verified> 
    <[error_message](*error_message)>some string</error_message>
  </Data>
  ```

{% endlist %}
 ||
|#

#### Узнайте больше

- [Коды ошибок и статусы](https://yandex.ru/dev/webmaster/doc/ru/reference/errors.md)






[*user-id]: Тип: `int64`. ID пользователя. Необходим для вызова любых ресурсов API Яндекс Вебмастера. Чтобы получить его, используйте метод [GET /v4/user](https://yandex.ru/dev/webmaster/doc/ru/reference/user.md).

[*host_url]: URI добавляемого сайта.

[*host_id3]: **Обязательный**

<!-- source: ru/_includes/reference/hosts-add-site/host_id/req.md -->
Да
<!-- endsource: ru/_includes/reference/hosts-add-site/host_id/req.md -->

**Тип**

<!-- source: ru/_includes/reference/hosts-add-site/host_id/type.md -->
`host id` (`string`)
<!-- endsource: ru/_includes/reference/hosts-add-site/host_id/type.md -->

**Описание**

<!-- source: ru/_includes/reference/hosts-add-site/host_id/desc.md -->
ID добавленного сайта.
<!-- endsource: ru/_includes/reference/hosts-add-site/host_id/desc.md -->