v1

latestOpenAPI 3.1.1Proprietary2026-07-26184406877.9 KB
Employee data Webhooks

Employee joined

Triggered when an employee is granted access, once the corresponding lifecycle entry becomes effective.

Lifecycle events are triggered automatically at midnight on the effective date of the lifecycle table entry (according to the site's timezone).

In the right panel, open Examples and select Payload Example to see a real payload.

postWebhookemployeeJoined

Headers

bob-signaturestring required
Example:EQScIBkAtTKFW0ictgt5zzOsqIc2+xGEsM88jOdLuW4CM/a3gLEfrKV+IC5IHx0xbirzLKPIfaZjCGwzuiyI8w==

Base64-encoded signature sent with each webhook request. Use it to verify that the request came from Bob. To verify webhook authenticity, see <a href="https://apidocs.hibob.com/reference/getting-started-webhooks#how-does-bob-calculate-the-signature" target="_blank">How does Bob calculate the signature</a>.

Payload

companyIdnumber required

The company ID

type'employee.joined' required

Event type for employee joined (access granted)

triggeredBystring required

The backend-id of the employee that triggered the event or 'system' for events triggered automatically by the system

triggeredAtstring date-time required

The timestamp when the event occurred

versionstring required

The webhook version

Response

Webhook received successfully