---
title: "Create a social security benefits record for an employment"
method: POST
path: "/v2/providers/employers/employees/employments/{employmentId}/socialsecuritybenefits"
tags: ["Social security benefits"]
---

# Create a social security benefits record for an employment

`POST /v2/providers/employers/employees/employments/{employmentId}/socialsecuritybenefits`

## Request

- Base URL: `https://api.loket.nl`
- URL: `https://api.loket.nl/v2/providers/employers/employees/employments/{employmentId}/socialsecuritybenefits`
- Auth: none required

__Activity name:__ <a href="https://developer.loket.nl/Activities/PostSocialSecurityBenefitByEmploymentId" target="_blank">PostSocialSecurityBenefitByEmploymentId</a><br>    <br><br>Create a social security benefits record for an employment<br>__Metadata :__ Possible options for fields of the type 'metadata' can be acquired (GET) by adding `/metadata` to the POST URL.<br><br>__Defaults :__ Default values for a new object can be acquired by adding `/defaults' to the POST URL.<br>

## Path parameters

- `employmentId` string, uuid, required

## Headers

- `Authorization` string, required
- `Accept` string, required

## Request body

- SocialSecurityBenefitsPostGet
  - `id` string, uuid: The unique identifier of an object (GUID/UUID)
  - `startDate` string, date: The start date of the entity. Valide values are either the startDate of the employment or the firstday of a payrolling year. A (broken chain)[./#section/Data/Date-chains] is maintained within this resource.
  - `endDate` string, date, nullable: The end date of the entity. The date is up to and including.
  - `supplementation` object
    - `type` object: Indicates whether and how supplementation should be applied. This is used when the employer supplements the pay out percentage.
      - `key` integer
      - `value` string
    - `percentage` number, double: If supplementation is applied then the supplementation percentage (up to) is registered here.
  - `benefit` BenefitPostGet
    - `type` object: The type of social security benefit that is applicable. Per type of benefit a so-called closed-chain input validation is used. This field cannot be changed after the initial post.
      - `key` integer
      - `value` string
    - `percentage` number, double: Pay out percentage of the benefit (deviating from the administration). This value determines the percentage to be applied, the only exception is when type of benefit is set to AOW where the percentage cannot be in altered (=0).

## Response `201`

Created

- object: a warning indacateds that the given payload is valide, however take notice of the warning this might ifluence behavour.
  - `version` Version
    - `obsoleteDate` string, date, nullable: The date (can be null) on which the `resourceVersion` is no longer supported/available
    - `resourceVersion` string, date: The resource version of the object in the response
  - `messages` object[]
    - `type` string: Indication of the type of message. See [the general documentation for more information](./#section/Response/Messages)
    - `description` string: Describes the message
    - `id` string, uuid, nullable: In some cases when the message may relate to a specific entity, or specific group of entities, this field provides the identifier of that entity
    - `code` integer: Identifying code for the message
    - `properties` string[]: An array that can contain additional information
  - `content` SocialSecurityBenefitsPostGet
    - `id` string, uuid: The unique identifier of an object (GUID/UUID)
    - `startDate` string, date: The start date of the entity. Valide values are either the startDate of the employment or the firstday of a payrolling year. A (broken chain)[./#section/Data/Date-chains] is maintained within this resource.
    - `endDate` string, date, nullable: The end date of the entity. The date is up to and including.
    - `supplementation` object
      - `type` object: Indicates whether and how supplementation should be applied. This is used when the employer supplements the pay out percentage.
        - `key` integer
        - `value` string
      - `percentage` number, double: If supplementation is applied then the supplementation percentage (up to) is registered here.
    - `benefit` BenefitPostGet
      - `type` object: The type of social security benefit that is applicable. Per type of benefit a so-called closed-chain input validation is used. This field cannot be changed after the initial post.
        - `key` integer
        - `value` string
      - `percentage` number, double: Pay out percentage of the benefit (deviating from the administration). This value determines the percentage to be applied, the only exception is when type of benefit is set to AOW where the percentage cannot be in altered (=0).

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/loket/apis/loket-api.md) - [All operations](https://skmtc.dev/loket/apis/loket-api/llms.txt) - [OpenAPI document](https://skmtc.dev/loket/apis/loket-api/revisions/32170564148f?raw)