---
title: "Create an entitlement entry for an employee"
method: POST
path: "/people/{id}/entitlement"
tags: ["Employee Tables"]
---

# Create an entitlement entry for an employee

`POST /people/{id}/entitlement`

## Request

- Base URL: `https://api.hibob.com/v1`
- URL: `https://api.hibob.com/v1/people/{id}/entitlement`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

Creates a new entitlement table entry for the employee. On success, returns the new entry id. Creating or updating entries may also sync current entitlement amounts onto derived employee fields such as `payroll.entitlement.<Type>.amount` (employee fields you can fetch with the <a href="https://apidocs.hibob.com/reference/post_people-search" target="_blank">People search</a> endpoint).<br /><br /> To read entitlement rows, use <a href="https://apidocs.hibob.com/reference/get_bulk-people-entitlement" target="_blank">List entitlement entries for a list of employees</a> (there is no per-employee GET).<br /><br /> **Required permissions**: People's Data > People's fields > Entitlement (Table) > Edit.

## Path parameters

- `id` string, required

## Request body

- CreateEntitlementEntry: Request body for creating or updating an entitlement entry. Do not send `id`; the system assigns it on create. On update, identify the row with the path `{entry_id}`.
  - `effectiveDate` string, date, required: Start of this timeline step (ISO 8601 date).
  - `entitlement` string, required: Entitlement type name from the company entitlement type list (for example `Lunch vouchers` or `Company Car`). To list available values, call the <a href="https://apidocs.hibob.com/reference/get_company-named-lists-listname" target="_blank">Get company list by name</a> endpoint with list name `entitlementType`.
  - `amount` CurrencyValue, required
    - `value` number, double, required
    - `currency` string, required: Three-letter currency code.
  - `endDate` string, date: Optional explicit end date for this entitlement period (ISO 8601 date).
  - `customColumns` object: Custom column values for this entry, keyed by column id.

## Response `200`

Entry created successfully.

- EntitlementEntryIdResponse
  - `entryId` integer, required: The id of the newly created entitlement table entry.

## Changes

- **2026-11-03** `9ac25373a355`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hibob/apis/employee-data-api/changes/people/:id/entitlement/post.md)

---

[API](https://skmtc.dev/hibob/apis/employee-data-api.md) - [All operations](https://skmtc.dev/hibob/apis/employee-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hibob/apis/employee-data-api/revisions/9ac25373a355?raw)