Webhook Subscriptions

Overview

The topic introduces the main information for Multi-source Employee API webhook subscriptions.

Webhook subscriptions

Try to simulate a subscription and explore subscription management options

Functionality

Multi-source Employee API subscription feature (or webhooks) enables you to track experience updates in selected profiles by setting up a callback URL to receive change notifications:

1. Choose the profiles you want to track (using an IDs list or Elasticsearch DSL filter query).

2. Provide a callback URL to receive notifications.

3. Receive notifications at your URL and retrieve the data using the Multi-source Employee API collection endpoint or Bulk Collect.

Use the following endpoints to subscribe to employee experience changes:

Request type	Endpoint
POST	/v2/subscriptions/experience_changes/employee_multi_source/ids
POST	/v2/subscriptions/experience_changes/employee_multi_source/es_dsl

After creating a webhook subscription, you will receive updates via webhooks next Monday. Updates will be sent once a week.

Webhook triggers

Experience changes

The subscribed experience change webhook is triggered when:

1. Employee starts a new experience position

2. Employee closes their previously open experience position.

Promotions (e.g., a new position at a company they previously worked for) do not trigger a webhook.

Rate limits

The number of requests allowed is limited.

Request type	Endpoint	Rate limits
POST	/v2/subscriptions/experience_changes/employee_multi_source/ids	9 requests per minute
POST	/v2/subscriptions/experience_changes/employee_multi_source/es_dsl	9 requests per minute