---
title: "Initiate the manage contact workflow for an employee"
method: POST
path: "/v2/providers/employers/employees/{employeeId}/workflow/InitiateManageContacts"
tags: ["Workflow employee"]
---

# Initiate the manage contact workflow for an employee

`POST /v2/providers/employers/employees/{employeeId}/workflow/InitiateManageContacts`

## Request

- Base URL: `https://api.loket.nl`
- URL: `https://api.loket.nl/v2/providers/employers/employees/{employeeId}/workflow/InitiateManageContacts`
- Auth: none required

__Activity name:__ <a href="https://developer.loket.nl/Activities/PostInitiateManageContactsWorkflowByEmployeeId" target="_blank">PostInitiateManageContactsWorkflowByEmployeeId</a><br>  <br><br>Allows the user to trigger a workflow to manage his contact information (Create, update and delete). The workflow may require the change to be approved.<br><br>__Metadata :__ Possible options for fields of the type 'metadata' can be acquired (GET) by adding `/metadata` to the POST URL.<br><br>__Defaults :__ none<br>

## Path parameters

- `employeeId` string, uuid, required

## Headers

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

## Request body

- union
  - Create2
    - `action` 'create'
    - `name` string: Name of the contact
    - `description` string: Describes the relationship of the contact to the employee
    - `phoneNumber` string, nullable: The phone number of the contact
    - `address` Address2, nullable
      - `street` string: Streetname of the address
      - `city` string: City of the address
      - `houseNumber` integer: House number of the address
      - `houseNumberAddition` string, nullable: An addition to further specify the house/door/postbox. For example used to specifty a room of floor number in addition to the house number.
      - `postalCode` string, nullable: The postal code of the address
      - `country` object
        - `key` integer: The key for the country. Possible values can be aquired via the metadata endpoint
        - `value` string: The name of the country
        - `isoCode` string: The ISO 3166-1 alpha-2 value for the country
    - `particularities` string, nullable: Extra information about the contact
    - `comment` string, nullable: An extra comment for the change request
  - Update2
    - `action` 'update'
    - `id` string, uuid: The unique identifier of an object (GUID/UUID)
    - `name` string: Name of the contact
    - `description` string: Describes the relationship of the contact to the employee
    - `phoneNumber` string, nullable: The phone number of the contact
    - `address` Address2, nullable
      - `street` string: Streetname of the address
      - `city` string: City of the address
      - `houseNumber` integer: House number of the address
      - `houseNumberAddition` string, nullable: An addition to further specify the house/door/postbox. For example used to specifty a room of floor number in addition to the house number.
      - `postalCode` string, nullable: The postal code of the address
      - `country` object
        - `key` integer: The key for the country. Possible values can be aquired via the metadata endpoint
        - `value` string: The name of the country
        - `isoCode` string: The ISO 3166-1 alpha-2 value for the country
    - `particularities` string, nullable: Extra information about the contact
    - `comment` string, nullable: An extra comment for the change request
  - Delete2
    - `action` 'delete'
    - `id` string, uuid: The unique identifier of an object (GUID/UUID)
    - `comment` string, nullable: An extra comment for the change request

## Response `202`

Accepted

- 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` Response
    - `id` string, uuid: The unique identifier of an object (GUID/UUID)

## 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)