---
title: "Initiate signature - Conceptemployee"
method: POST
path: "/v2/providers/employers/conceptemployees/{conceptEmployeeId}/documents/{documentId}/signature/initiate"
tags: ["Sign document"]
---

# Initiate signature - Conceptemployee

`POST /v2/providers/employers/conceptemployees/{conceptEmployeeId}/documents/{documentId}/signature/initiate`

## Request

- Base URL: `https://api.loket.nl`
- URL: `https://api.loket.nl/v2/providers/employers/conceptemployees/{conceptEmployeeId}/documents/{documentId}/signature/initiate`
- Auth: none required

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

__Metadata:__ No metadata available. Defaults are available by adding /defaults to the path.

Initiate the proces to sign a document for an employment by one or more signers.

## Path parameters

- `conceptEmployeeId` string, uuid, required
- `documentId` string, required

## Headers

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

## Request body

- DocumentSignObject[]
  - `emailAddress` string: The email address of the signer.
  - `name` string: The name of the signer
  - `mobilePhoneNumber` string: The mobile phone number of the signer. In E.164 format
  - `signingOrder` integer, nullable: When filled, this integer is used to set the order in which the signers have to sign the document. An email will be sent to all signers with the first SigningOrder number. When signed an email will be sent to all signers with the second SingingOrder. Etcetera.

## Response `200`

Initiated

- object: a warning indacateds that the given payload is valide, however take notice of the warning this might ifluence behavour.
  - `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` SignatureDocumentStatusObject
    - `signDocumentStatus` object: Status of the signature at document level
      - `Key` string: The key of the status
      - `Value` string: The description of the status.

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