Skip to main content

Event Filters

Event Filters allow you to reduce the scope of received events. They currently provide filtering capabilities by entity type and HTTP action applied over them.

Some possible event filters that you can build would be:

  1. All events for created projects:
    event_filters": [
{"entity": "project", "action": "created"}
]
  1. All events for tags:
    event_filters": [
{"entity": "tag", "action": "*"}
]
  1. All events that occurred in a workspace:
    event_filters": [
{"entity": "*", "action": "*"}
]
  1. All updated time entries and clients:
    event_filters": [
{"entity": "time_entry", "action": "updated"},
{"entity": "client", "action": "updated"}
]

In any case, there would be authorization checks in place to also filter out the events that the creator of the subscription does not have permission to see.

You can get a list of supported entities and actions by using the event_filters endpoint.

© 2022 Toggl. All rights reserved.