---
metadata:
  - name: generator
    content: Diplodoc Platform v5.48.2
alternate:
  - https://yandex.ru/dev/dialogs/smart-home/doc/en/reference-alerts/resources-alerts.md
  - https://yandex.ru/dev/dialogs/smart-home/doc/ru/reference-alerts/resources-alerts.md
---
# Notification service operating protocol

You can find the workflow chart for the notification service in [Getting started](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/alerts.md).

#|
||
**Method**
|
**Resource**
|
**Description**
||

||
[POST](https://yandex.ru/dev/dialogs/smart-home/doc/en/reference-alerts/post-skill_id-callback-discovery.md)
|
`/api/v1/skills/{skill_id}/callback/discovery`
|
Notification about change of parameters of a device
||

||
[POST](https://yandex.ru/dev/dialogs/smart-home/doc/en/reference-alerts/post-skill_id-callback-state.md)
|
`/api/v1/skills/{skill_id}/callback/state`
|
Notification about device state change
||
|#



{% note info %}

The notification service is available only for published skills. If your skill is still under development, you can make it private for the  [testing](https://yandex.ru/dev/dialogs/smart-home/doc/en/testing.md) period so that external users can't access it.

{% endnote %}


## Access and authorization {#oauth}

{% note warning %}

You can only use the notification service API on behalf of the Yandex user that created the skill in Yandex Dialogs. To do this, get an [OAuth token for Yandex Dialogs](https://oauth.yandex.com/authorize?response_type=token&client_id=c473ca268cd749d3a8371351a8f2bcbd).

{% endnote %}

Host for all API requests:

```bash translate=no
https://dialogs.yandex.net
```

Specify the token in the `Authorization` header of each request to the notification service API:

```http
curl -i -X POST 'https://dialogs.yandex.net/api/v1/skills/user-test-skill/callback/state' \
-H 'Authorization: OAuth OUR_OAUTH_TOKEN' \
-H 'Content-Type: application/json' \
```


<!-- {% include [support-support-button](../_includes/about/id-support/support-button.md) %}-->