---
title: "Create personal link"
method: POST
path: "/documents/{document}/users/{documentUser}/personal-link"
tags: ["Document Operations"]
---

# Create personal link

`POST /documents/{document}/users/{documentUser}/personal-link`

<small>Requires an API token with the **Document Manager** role.</small>

Creates a [personal link](/#shareable-links) tied to the [document user](/#document-users). Anyone who has
the link URL can access the document as that user, so treat the URL like a secret. Delivering the link to
the user is up to you; fynk sends no email.

A document user has at most one active personal link at a time; if one already exists, a `409` response is
returned. Delete the existing link first to create a new one with a fresh URL.

> **Note:** Personal links can only be created for users without a fynk account user in your account
> (`has_account_user` is `false`), and not while the document is in the `draft` or `approved_draft` stage.
> Attempting either will return a `409` response.

## Path parameters

- `document` string, required
- `documentUser` string, required

## Request body

- StorePersonalLinkRequest
  - `expires_at` string, date-time, nullable — When the link stops working. Defaults to 3 months from now; pass `null` for a link that never expires
  - `message` string, nullable — A personal message shown to the user when they open the link

## Response `201`

`ShareableLinkResource`

- object
  - `data` ShareableLinkResource, required
    - `uuid` string, required
    - `url` string, required — The link URL. Treat it like a secret: anyone who has the URL can access the document with it
    - `expires_at` string, date-time, nullable, required — When the link stops working. `null` means the link never expires
    - `message` string, nullable, required — A personal message shown when the link is opened. Always `null` for public links
    - `created_at` string, date-time, nullable, required

## Other responses

- `401` — Unauthenticated
- `403` — Authorization error
- `404` — Not found
- `409` — The resource's current state prevents the requested change
- `422` — Validation error

---

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