---
title: "Employee joined"
method: POST
path: "employeeJoined"
tags: ["Employee data Webhooks"]
---

# Employee joined

`POST employeeJoined` (webhook)

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.

## Headers

- `bob-signature` string, required

## Payload

- EmployeeJoinedEvent — Base webhook event structure containing common webhook properties
  - `companyId` number, required — The company ID
  - `type` 'employee.joined', required — Event type for employee joined (access granted)
  - `triggeredBy` string, required — The backend-id of the employee that triggered the event or 'system' for events triggered automatically by the system
  - `triggeredAt` string, date-time, required — The timestamp when the event occurred
  - `version` string, required — The webhook version
  - `data` object, required — Data payload for lifecycle events (joined, left, activated, inactivated, temporaryLeave)
    - `employeeId` string, required — The unique identifier of the employee

## Acknowledgement `200`

Webhook received successfully

## Other responses

- `400` — Invalid webhook payload

---

[API](https://skmtc.net/hibob/apis/employee-data-api.md) · [All operations](https://skmtc.net/hibob/apis/employee-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hibob/employee-data-api/revisions/0781ebbdda91/schema)