Overview

  1. Overview
  2. Methods

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.