---
title: "Create a new signature request on a file"
method: POST
path: "/v1/org/{orgId}/signature-request/file/{fileId}"
tags: ["signature-request"]
---

# Create a new signature request on a file

`POST /v1/org/{orgId}/signature-request/file/{fileId}`

## Request

- Base URL: `https://localhost`
- URL: `https://localhost/v1/org/{orgId}/signature-request/file/{fileId}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/charthop/apis/charthop-api/docs/v1/org/:orgId/signature-request/file/:fileId/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `orgId` string, required
- `fileId` string, required

## Request body

- CreateSignatureRequestRequest
  - `signerUserIds` string[], required
  - `message` string
  - `messageChannel` MessageChannelConfig
    - `channels` string[], required
    - `alwaysEmail` boolean, required
  - `isSequential` boolean

## Other responses

- `400`: bad request
- `401`: not authorized
- `404`: not found

---

[API](https://skmtc.dev/charthop/apis/charthop-api.md) - [All operations](https://skmtc.dev/charthop/apis/charthop-api/llms.txt) - [OpenAPI document](https://skmtc.dev/charthop/apis/charthop-api/revisions/c4ab2e4f2575?raw)