---
title: "Create an employer"
method: POST
path: "/v2/providers/{providerId}/employers"
tags: ["Employer"]
---

# Create an employer

`POST /v2/providers/{providerId}/employers`

__Activity name :__ <a href="https://developer.loket.nl/Activities/PostEmployerByProviderId" target="_blank">PostEmployerByProviderId</a>

Create an employee for the provider (administratiekantoor) identified by the given providerId.
Please take note of the following; a newly created Employer is not immediately accessible for the user.
As this would require adding the Employer to a specific Loket team (which is a separate activity). 
Even after adding the Employer to a team, it may take a few minutes before the Employer is accessible for the user because of caching.

__Metadata :__  Possible options for fields of the type 'metadata' can be acquired (GET) by adding `/metadata` to the POST URL.

__Defaults :__ Default values for a new object can be acquired by adding `/defaults' to the POST URL.

## Path parameters

- `providerId` 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)