Table entry updated

wbhk

tableEntryUpdated

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 either:

entryId (the id field in the payload) — Identifies the entry in non-historical tables (e.g., custom tables, bank accounts). For these tables, effectiveDate will be null.
effectiveDate — Identifies the entry in historical tables. For these tables, id will be null.

To learn more about table types, see Employee data modeling.

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 employee.updated event with the list of changed field IDs in fieldUpdates. 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.

Payload

companyId

number

required

The company ID

type

string

enum

required

Event type for table entry updated

Allowed:

triggeredBy

string

required

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

triggeredAt

string

required

The timestamp when the event occurred (ISO 8601-style string)

version

string

required

The webhook version (e.g., v2)

data

object

required

Data payload for table.entry.created and table.entry.updated events

Headers

bob-signature

string

required

Base64-encoded signature sent with each webhook request. Use it to verify that the request came from Bob. To verify webhook authenticity, see How does Bob calculate the signature.

get-table

string

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

Responses

200

Webhook received successfully

Loading…

400Invalid webhook payload