---
title: "Create signature request"
method: POST
path: "/api/1/folders/{folder_ID}/sign_requests"
tags: ["Signature requests"]
---

# Create signature request

`POST /api/1/folders/{folder_ID}/sign_requests`

## Request body

- object
  - `label` string, required — Label of signature request.
  - `template` integer — ID of signature request template.
  - `reminders` integer[] — Positive integers for days after the request is sent; negative integers for days before the due date
  - `due_at` string, nullable — Sets the due date to. Used for the status, and sending reminders
  - `roles` object[], required — Roles (users) assigned to the signature request
    - `signer` integer, required — ID of user
    - `id` integer — Only when a signature template is used: the ID of the role to associate the user to
    - `auth` string — The only supported value is "SMS"
    - `question` string — When the "auth" is "SMS", this is the phone number used to MFA authentication to sign the documents
  - `files` integer[], required — IDs of files requested to be signed
  - `ordered` boolean — Set to true to respect signing order. Defaults to false.
  - `reassign` boolean — Set to true to enable reassignments of signers. A signer can delegate signing to another user. Defaults to false.

## Response `200`

- object
  - `Id` integer
  - `@type` string
  - `@id` string
  - `Label` string
  - `PackageId` string
  - `activated_at` string, nullable
  - `completed_at` string, nullable
  - `cancelled_at` string, nullable
  - `created_at` string
  - `archived_at` string, nullable
  - `Link` string
  - `OrderedSigning` boolean
  - `Reassignment` boolean
  - `UsingTemplate` boolean
  - `folder` string, nullable
  - `due_at` string, nullable

---

[API](https://skmtc.net/convoflo/apis/convoflo-rest-api.md) · [All operations](https://skmtc.net/convoflo/apis/convoflo-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/convoflo/convoflo-rest-api/versions/fed4481f0476/schema)