v1

latestOpenAPI 3.1.1Proprietary2026-07-26184406877.9 KB
Employee data Webhooks

Table entry updated

Triggered when an entry is updated in an employee's table (including out-of-the-box and custom tables).

Does not apply to Training, Equity, Positions, or Jobs tables.

To identify the row/entry when fetching using the API, use the property that appears in the payload for that table type:

  • id — Included only for non-historical tables (e.g. custom tables, bank accounts). Identifies the entry row. Omitted for historical tables.
  • effectiveDate — Included only for historical tables. Identifies the entry row for that table type. Omitted for non-historical tables.

Each event includes exactly one of effectiveDate or id inside data, depending on whether the table is historical.

To learn more about table types, see <a href="https://apidocs.hibob.com/docs/explore-employee-data#employee-data-modeling" target="_blank">Employee data modeling</a>.

When a table entry is created or updated, it may also update employee-level fields (e.g. derived or linked). In that case you will also receive an <a href="https://apidocs.hibob.com/reference/post_webhook_employee-updated" target="_blank">employee.updated</a> event with the list of changed field IDs in <code>fieldUpdates</code>. Bank accounts and custom tables do not trigger this additional employee.updated event.

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

postWebhooktableEntryUpdated

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

get-tablestring
Example:https://api.hibob.com/v1/people/custom-tables/3332883884017713938/category_1716214820047__table_1716214839517

Present only for custom tables. The URL to call to read this table entry. For out-of-the-box tables the path is well known, but for custom tables this header provides the full URL with the table ID (e.g. category_1716214820047__table_1716214839517) already in the right place. Example: https://api.hibob.com/v1/people/custom-tables/{employeeId}/{custom_table_id}.

Payload

companyIdnumber required

The company ID

type'table.entry.updated' required

Event type for table entry updated

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