Overview
Overview
You can create a subscription and receive notifications from Toloka when certain events occur, for example:
- When a pool closes.
- When a task's status changes to a specified one.
- When an aggregated score appears after dynamic overlap.
The events that you want to be notified about are set when creating a subscription.
Notifications about the events you're subscribed to are sent in JSON format. For a description of notification data, see Notification format.
To create a subscription, leave a request in the Issues with project settings form.
Methods
| Method | Endpoint | Overview |
|---|---|---|
| PUT | /webhook-subscriptions | Creates one or more subscriptions. |
| GET | /webhook-subscriptions/<subscription_id> | Gets subscription data. |
| GET | /webhook-subscriptions | Gets data for multiple active subscriptions. |
| DELETE | /webhook-subscriptions/<subscription_id> | Deletes a subscription. |
| POST | api/v1/webhook-subscriptions/<subscription_id>/test | Sends a test notification to the URL specified in the subscription. |
| Method | Endpoint | Overview |
|---|---|---|
| PUT | /webhook-subscriptions | Creates one or more subscriptions. |
| GET | /webhook-subscriptions/<subscription_id> | Gets subscription data. |
| GET | /webhook-subscriptions | Gets data for multiple active subscriptions. |
| DELETE | /webhook-subscriptions/<subscription_id> | Deletes a subscription. |
| POST | api/v1/webhook-subscriptions/<subscription_id>/test | Sends a test notification to the URL specified in the subscription. |