---
title: "Create Document Session for Embedded Sign"
method: POST
path: "/public/v1/documents/{id}/session"
tags: ["Documents"]
---

# Create Document Session for Embedded Sign

`POST /public/v1/documents/{id}/session`

Creates a document session for a recipient to view and sign a document.

> 📘 How to create an Embedded Sign session
> For more information on how to create an Embedded Sign session, see the [Embedded Signing](https://developers.pandadoc.com/docs/embedded-signing) documentation.

## Path parameters

- `id` string, required

## Request body

- DocumentCreateLinkRequest
  - `recipient` string, required — Email address of the person who will receive access to the document.
  - `lifetime` number — The duration in seconds for which the document link will remain valid. The link will expire and become inaccessible after this time period. For security, we recommend setting the lifetime to less than one year (e.g., `"lifetime": 31535999`). If not specified, the default value is 1 hour (3600 seconds).

## Response `201`

OK

- DocumentCreateLinkResponse
  - `id` string — The session ID.
  - `expires_at` string — The date and time when the session will expire.

## Other responses

- `400` — Bad Request
- `401` — Authentication error
- `403` — Permission error
- `404` — Not found
- `429` — Too Many Requests

---

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