---
title: "POST /papersign/documents/{id}/participants/{participantKey}/link"
method: POST
path: "/papersign/documents/{id}/participants/{participantKey}/link"
tags: ["Papersign Documents"]
---

# POST /papersign/documents/{id}/participants/{participantKey}/link

`POST /papersign/documents/{id}/participants/{participantKey}/link`

This endpoint generates a signing link for a signer, which you can share with them directly instead of having Paperform email them a notification.

The link is returned only in this response and cannot be retrieved again, so store it when you receive it. Generating a link invalidates any link previously generated for the same signer — only the most recently generated link will work. The link is valid for one week.

The document must have been sent (be in progress) and the signer must be pending a signature.
Please note that this feature is exclusively available as part of the [Papersign API](https://paperform.co/products/papersign/#pricing).

## Path parameters

- `id` string, required
- `participantKey` string, required

## Response `200`

Successfully generated a signing link for the signer

- object
  - `status` 'ok'
  - `results` object
    - `link` GeneratedLink
      - `participant_key` string, required — The key of the signer the link belongs to.
      - `participant_name` string, required — The name of the signer the link belongs to.
      - `link` string, uri, required — The signing link for the signer. Valid for one week.

## Other responses

- `400` — Invalid Request
- `401` — Unauthorized
- `403` — Not Permitted
- `404` — Not Found
- `422` — Validation Error
- `429` — Too Many Requests
- `5XX` — Unexpected Error

---

[API](https://skmtc.dev/paperform/apis/paperform-api.md) · [All operations](https://skmtc.dev/paperform/apis/paperform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/paperform/paperform-api/revisions/dc1e62b7063d/schema)