Create custom events for webhooks in Label Studio

If you want to trigger custom events for webhooks in Label Studio, you can extend the webhook event model.

Create a custom webhook event

To create a custom webhook event, add your own action to the WebhookActions model.

For example:

class WebhookAction(models.Model):
    ...
    SOMETHING_HAPPENED = 'SOMETHING_HAPPENED'
    ...
    ACTIONS = {
        SOMETHING_HAPPENED: {
            'name': _('Something happened'),
            'description': _("A thing happened. We wanted to let you know."),
            'key': 'something',
        },
        ...
    ...

After declaring the action and the associated properties and payload details in the WebhookAction class, call the event action in the code where it occurs. For example:

...python
result = do_something()
emit_webhooks(organization, WebhookAction.SOMETHING_HAPPENED, {'something': [result]})
...

You can retrieve the organization details using Organization.objects.first().

Call event actions with Python functions

There are several functions you can use to call event actions. Refer to the following table:

Call event actions with decorators in API source code

You can use decorators with the CRUD REST methods to send event actions to webhooks. You can use the following:

Couldn't find what you were looking for? Please let us know on Slack 
If you found an error, you can file an issue on GitHub!