---
updatedAt: 2026-05-05T09:50:12.000Z
agentTools:
  projectIndex: https://apidocs.hibob.com/llms.txt
---

# 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.


# OpenAPI definition

```json
{
  "openapi": "3.1.1",
  "info": {
    "title": "Employee data API",
    "description": "Access your employees data with the Public API",
    "license": {
      "name": "Proprietary",
      "url": "https://apidocs.hibob.com/docs/api-terms-of-use"
    },
    "contact": {
      "name": "Hi Bob, Inc."
    },
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://api.hibob.com/v1",
      "description": "Production"
    },
    {
      "url": "https://api.sandbox.hibob.com/v1",
      "description": "Sandbox"
    }
  ],
  "x-readme": {
    "metrics-enabled": false
  },
  "tags": [
    {
      "name": "Employee data Webhooks",
      "description": "Webhook events for employee and table entry operations"
    }
  ],
  "webhooks": {
    "employeeJoined": {
      "post": {
        "operationId": "post_webhook_employee-joined",
        "tags": [
          "Employee data Webhooks"
        ],
        "summary": "Employee joined",
        "description": "Triggered when an employee is granted access, once the corresponding\nlifecycle entry becomes effective.\n\nLifecycle events are triggered automatically at midnight on the effective\ndate of the lifecycle table entry (according to the site's timezone).\n\nIn the right panel, open **Examples** and select **Payload Example** to see a real payload.\n",
        "parameters": [
          {
            "name": "bob-signature",
            "in": "header",
            "required": true,
            "description": "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>.",
            "schema": {
              "type": "string",
              "example": "EQScIBkAtTKFW0ictgt5zzOsqIc2+xGEsM88jOdLuW4CM/a3gLEfrKV+IC5IHx0xbirzLKPIfaZjCGwzuiyI8w=="
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EmployeeJoinedEvent"
              },
              "example": {
                "companyId": 637323,
                "type": "employee.joined",
                "triggeredBy": "3332883804594373380",
                "triggeredAt": "2024-12-26T11:29:14.399997",
                "version": "v2",
                "data": {
                  "employeeId": "3332883894235038486"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Webhook received successfully"
          },
          "400": {
            "description": "Invalid webhook payload",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "security": []
      }
    }
  },
  "components": {
    "schemas": {
      "WebhookEvent": {
        "type": "object",
        "description": "Base webhook event structure containing common webhook properties",
        "properties": {
          "companyId": {
            "type": "number",
            "description": "The company ID"
          },
          "type": {
            "type": "string",
            "description": "The event type (e.g., employee.created)"
          },
          "triggeredBy": {
            "type": "string",
            "description": "The backend-id of the employee that triggered the event, or 'system' for system-triggered events"
          },
          "triggeredAt": {
            "type": "string",
            "description": "The timestamp when the event occurred (ISO 8601-style string)"
          },
          "version": {
            "type": "string",
            "description": "The webhook version (e.g., v2)"
          },
          "data": {
            "type": "object",
            "description": "Event-specific payload; structure varies by event type"
          }
        },
        "required": [
          "companyId",
          "type",
          "triggeredBy",
          "triggeredAt",
          "version",
          "data"
        ]
      },
      "EmployeeLifecycleEventData": {
        "type": "object",
        "description": "Data payload for lifecycle events (joined, left, activated, inactivated, temporaryLeave)",
        "properties": {
          "employeeId": {
            "type": "string",
            "description": "The unique identifier of the employee"
          }
        },
        "required": [
          "employeeId"
        ]
      },
      "EmployeeJoinedEvent": {
        "allOf": [
          {
            "$ref": "#/components/schemas/WebhookEvent"
          },
          {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "employee.joined"
                ],
                "description": "Event type for employee joined (access granted)"
              },
              "data": {
                "$ref": "#/components/schemas/EmployeeLifecycleEventData"
              }
            }
          }
        ]
      },
      "Error": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string",
            "description": "The unique identifier of the error."
          },
          "error": {
            "type": "string",
            "description": "A human readable error message."
          }
        }
      }
    }
  }
}
```

# Sibling pages

* [Employee created](https://apidocs.hibob.com/reference/post_webhook_employee-created.md)
* [Employee updated](https://apidocs.hibob.com/reference/post_webhook_employee-updated.md)
* [Employee deleted](https://apidocs.hibob.com/reference/post_webhook_employee-deleted.md)
* [Employee terminated](https://apidocs.hibob.com/reference/post_webhook_employee-left.md)
* [Employee activated](https://apidocs.hibob.com/reference/post_webhook_employee-activated.md)
* [Employee inactivated](https://apidocs.hibob.com/reference/post_webhook_employee-inactivated.md)
* [Employee immediate access revocation](https://apidocs.hibob.com/reference/post_webhook_employee-access-revoked-immediately.md)
* [Employee on temporary leave](https://apidocs.hibob.com/reference/post_webhook_employee-temporary-leave.md)
* [Table entry created](https://apidocs.hibob.com/reference/post_webhook_table-entry-created.md)
* [Table entry updated](https://apidocs.hibob.com/reference/post_webhook_table-entry-updated.md)