Adding a site

Adds the site to the user's site list.

Request format

POST https://api.webmaster.yandex.net/v4/user/{user-id}/hosts

user-id

Type: int64. User ID. Required when calling all Yandex.Webmaster API resources. To get it, use the GET /v4/user method.

In the request body, specify the new site name and the desired data type in the Content-type header (application/json or application/xml):

JSON

XML

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

<Data>
    <host_url>http://example.com</host_url>
</Data>

Parameter	Description
`host_url`	URI of the site to add.

JSON

XML

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

<Data>
    <host_id>http:example.com:80</host_id>
</Data>

Parameter	Required	Type	Description
`host_id`	Yes	`host id` (`string`)	ID of the added site.

To view the response structure in detail, click the reason.

Code	Reason	Description
201	CREATED	The site was added to the user's list.
403	HOSTS_LIMIT_EXCEEDED	The number of sites in the user's site list exceeded the limit (the current limit is 1703). JSON XML `{ "error_code": "HOSTS_LIMIT_EXCEEDED", "limit": 1, "error_message": "explicit error message" }` `<Data> <error_code>HOSTS_LIMIT_EXCEEDED</error_code> <limit>1</limit> <error_message>explicit error message</error_message> </Data>`
403	INVALID_USER_ID	The ID of the user who issued the token differs from the one specified in the request. In the examples below, `{user_id}` shows the correct `uid` of the OAuth token owner. JSON XML `{ "error_code": "INVALID_USER_ID", "available_user_id": 1, "error_message": "Invalid user id. {user_id} should be used." }` `<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>`
409	HOST_ALREADY_ADDED	A site with this name was already added to the user's site list. JSON XML `{ "error_code": "HOST_ALREADY_ADDED", "host_id": "http:ya.ru:80", "verified": false, "error_message": "some string" }` `<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>`