Document Operations

Create personal link

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

POST

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

curl --request POST \
  --url https://app.fynk.com/v1/api/documents/{document}/users/{documentUser}/personal-link \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "expires_at": "2026-10-19T12:00:00Z",
  "message": "Hi Emily, please review the updated contract."
}
'

{
  "data": {
    "created_at": "2023-11-07T05:31:56Z",
    "expires_at": "2026-10-19T12:00:00Z",
    "message": "Hi Emily, please review the updated contract.",
    "url": "https:app.fynk.com/share/5cbe6ed1-49a9-40dc-a1c4-9e5a3c9a08f0?token=...",
    "uuid": "5cbe6ed1-49a9-40dc-a1c4-9e5a3c9a08f0"
  }
}

Creates a personal link tied to the document user. 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.