OS1 Services
Webhooks
5 min
introduction the webhook service provides a simple, streamlined, and reliable conduit between the event publishers and subscribers for https //docs getos1 com/publishing webhook events , developers of services that generate events, it offers an efficient way to broadcast these events without complex integrations like kafka streams on the other hand, https //docs getos1 com/subscribing to webhook events , mainly app developers, can easily subscribe to these events, enabling real time responsiveness in their applications this service simplifies the process of sending and receiving event notifications, ensuring seamless and real time data flow between publishers and subscribers how it works here's a brief overview of the process create app configuration apps that want to act as publishers need to register using two details their permission requirements for subscribers and a name that subscribers will use to identify the app event registration publishers register their events with the webhook service, detailing the events they will broadcast event subscriptions consumer apps can retrieve and subscribe to registered events and specify which event types they want updates on processing and filtering the webhook service processes events, applies necessary filters, and forwards only the relevant events to the subscribers' specified webhook endpoints customizable subscriptions subscriptions can be customized to include either core, custom, or both attributes of the events reliable delivery the service ensures reliable delivery of events, managing retries and backoffs effectively in case of any delivery issues to guarantee that events reach their intended destinations apis app configurations https //docs getos1 com/reference/create app configuration registers configuration for an app publishing events https //docs getos1 com/reference/get app configuration details retrieves the configuration details for registered apps https //docs getos1 com/reference/update app configuration updates configuration details for an app events registration apis for publishers https //docs getos1 com/reference/register events register multiple event configurations https //docs getos1 com/reference/get all events retrieve all registered events https //docs getos1 com/reference/update event details update details and configurations of specific events https //docs getos1 com/reference/bulk delete events facilitate bulk deletion of registered events subscriptions apis for consumers https //docs getos1 com/reference/create subscription create a new subscription to webhook notifications for specific https //docs getos1 com/reference/get subscriptions retrieve a paginated list of subscriptions for an application https //docs getos1 com/reference/update subscription update configurations of an existing subscription https //docs getos1 com/reference/get subscription by id fetch details of a specific subscription using its id https //docs getos1 com/reference/addremove events to the subscription add or remove events from an existing subscription https //docs getos1 com/reference/get subscription executions obtain a paginated list of executions for a specific subscription