---
title: "Create a concept employee for an employer"
method: POST
path: "/v2/providers/employers/{employerId}/conceptemployees"
tags: ["Concept employee"]
---

# Create a concept employee for an employer

`POST /v2/providers/employers/{employerId}/conceptemployees`

__Activity name :__ <a href="https://developer.loket.nl/Activities/PostConceptEmployeeByEmployerId" target="_blank">PostConceptEmployeeByEmployerId</a><br><br>Create a concept employee for an employer<br><br>* Possible options (metadata) for generic fields of the type \metadata\" can be acquired (GET) by adding `/metadata` to the URL.<br>* Possible options dependent on a specific payrollAdministration can be acquired via `../v2/providers/employers/conceptemployees/metadata/payrolladministration/{payrollAdministrationId}`.<br>* Possible options for payGrade can be acquired via `../v2/providers/employers/conceptemployees/metadata/payrolladministration/{payrollAdministrationId}/payscale/{payScaleKey}`.<br>A `payGrade` has time based values dictating the wage for a given period. These values can be acquired by performing another metadata request to GET `../v2/providers/employers/conceptemployees/metadata/payrolladministration/{payrollAdministrationId}/payscale/{payScaleKey}/paygrade/{payGradeKey}`. This endpoint has the optional parameter \"date\" that may be used to specifying a measure date.<br><br>__Defaults :__ Default values for a new object can be acquired by adding `/defaults` to the POST URL. <br><br>        <br>Default values that are dependent on the selected payroll administration can be acquired by adding `/v2/providers/employers/conceptemployees/defaults/payrolladministration/{payrollAdministrationId}` to the POST URL.<br><br>__NonPayrollAdministrations__ For nonPayrollAdministrations the equivalent MetaData-endpoints are also available as described above. However NO specific defaults endpoint is available for the nonPayrollAdministration.<br>"

## Path parameters

- `employerId` string, uuid, required

## Headers

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

## Response `201`

Created

## Other responses

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

---

[API](https://skmtc.net/loket/apis/loket-api.md) · [All operations](https://skmtc.net/loket/apis/loket-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/loket/loket-api/revisions/32d1693f8db8/schema)