Webhook Listeners
platform.extensions.listeners
A webhook listener receives events from an external system at a Moveworks URL, checks them, and passes the payload to the system plugins subscribed to it.
- Endpoint:
/platform/extensions/listeners| Methods: GET, PATCH, POST - Request shape: fields go at the top level of the JSON body, with no
resourcewrapper. The item’sidgoes in the URL for reads and updates, not in the body. - Updates: a JSON merge-patch with
version: {num, change_description}from your last read. Lists of objects merge row by row, so read first and send the whole list when you remove or reorder rows. See Tool Studio. - References: System plugins subscribe to a listener with its
idintriggering_config.system_triggering_config.event_subscriptions[].listener_id.
Endpoints
All paths are relative to https://api.moveworks.ai/configurations/v1alpha1. Each endpoint page lists the request and response schema, an example, and the errors it can return.
Rules the API checks
display_nameis required.- Up to 5 entries in
verification.validations. debounce.window_secondsis one of 0, 30, 60, 180, 300, 600, 900, 1800, 2700 or 3600.- The server generates
url_uuids, which make up the listener’s public URL. You can’t change them through the API. signature_verification.secret_tokencomes back redacted.