Youforce Webhooks

Introduction

Webhooks are a messaging mechanism that improves the integration experience between two systems by minimizing waiting times — making them especially well suited for integrations where immediate updates matter.

Unlike the classic API consumption model, where the consumer has to keep polling for changes, webhooks provide a reactive integration: the consumer simply waits for changes to arrive, resulting in a faster integration with minimal waiting times.

For example, when a mutation happens in HR Core — such as an update to the organization unit of a particular employment — our services send an HTTPS POST request to a web address you have configured in advance. This message includes detailed information about what happened, using a format similar to the domain APIs, so integrators can handle the information easily and consistently.


Youforce Webhooks Model

Like the Youforce APIs, webhooks are organized by domain. Each domain has its own webhook publisher with its own set of events. Applications can subscribe to one or more events through the Visma Developer Portal.

To receive events, you need to:

  1. Subscribe to the correct event(s) from the Youforce Publisher application in the Visma Connect Developer Portal.
  2. Provide the Client ID you created, so we can authorize you to receive those events.

Once subscribed, you will start receiving all matching changes as they occur.

For full details on integrating with webhooks and Visma Connect, see Webhook Dispatcher.

Youforce Publisher-Subscriber model