---
metadata:
  - name: generator
    content: Diplodoc Platform v5.64.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
  - href: https://yandex.ru/dev/webmaster/doc/ru/reference/hosts-add-site.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.ru/dev/webmaster/doc/ru/llms.txt?revision=r21838267
    rel: describedby
keywords: список сайтов
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/webmaster/doc/ru/llms.txt?revision=r21838267


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

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

## Формат запроса {#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>HOSTS_LIMIT_EXCEEDED</error_code>
     <limit>1</limit>
     <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>INVALID_USER_ID</error_code>
      <available_user_id>1</available_user_id>
      <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>HOST_ALREADY_ADDED</error_code> 
    <host_id>http:ya.ru:80</host_id> 
    <verified>false</verified> 
    <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 -->