---
title: "Create an automatic signature"
method: POST
path: "/v2/signature"
tags: ["Signature"]
---

# Create an automatic signature

`POST /v2/signature`

## Request

- Base URL: `https://api.sandbox.eu.bandyer.com`
- URL: `https://api.sandbox.eu.bandyer.com/v2/signature`
- Auth: API key in header `apikey`

In an active call, an operator can create a signature document using this endpoint that will fill the information and send a notification to the client to sign the document.
After that, the operator can download the signed document. A webhook event `on_signature_enveloped_inserted` is sent after a signature is created.

## Request body `multipart/form-data`

- object
  - `friendly_name` string, required: Envelope name. This is a string which describes the name of the document to be signed. This name will be seen by the sender in the status window and by the receiver in the signing request.
  - `room_id` string, required: Room Id of the active room in which to issue a signing request.
  - `sender_id` string, required: Operator's user id. The operator must be a plus user with signing feature enabled.
  - `receiver_id` string, required: Client's user id. The client is generally a basic user.
  - `template_id` string, required: Signature template identifier.
  - `email` string, required: Receiver's email where to receive a copy of the signed document.
  - `phone` string, required: Receiver's phone number. It must match the following regex `/^(\+|00)[0-9]{6,20}$/`
  - `first_name` string, required: Receiver's first name.
  - `last_name` string, required: Receiver's last name.
  - `document` string, binary, required: the document to sign.
  - `fiscal_code` string: Fiscal or VAT code of the receiver. Requirement depends on local fiscal laws.
  - `email_cc` string: CSV delimited string of the additional emails on which to receive notifications about the signing process. Currently supported only by GoSign provider.

## Response `202`

`provider_id` for downloading the signed document when completed.

## Other responses

- `422`: Unprocessable Content

---

[API](https://skmtc.dev/kaleyra/apis/kaleyra-video-rest-api-v2.md) - [All operations](https://skmtc.dev/kaleyra/apis/kaleyra-video-rest-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/kaleyra/apis/kaleyra-video-rest-api-v2/revisions/4424fd54ae42?raw)