---
title: "Obtain link that can be used to prepare the eSignature package"
method: POST
path: "/e-signature-packages/{eSignaturePackageId}/actions/obtain-preparation-link"
tags: ["Actions"]
---

# Obtain link that can be used to prepare the eSignature package

`POST /e-signature-packages/{eSignaturePackageId}/actions/obtain-preparation-link`

## Request

- Base URL: `https://rest.api.pactima.com/v1`
- URL: `https://rest.api.pactima.com/v1/e-signature-packages/{eSignaturePackageId}/actions/obtain-preparation-link`
- Auth: HTTP bearer

Create a link that can be used to request the package. The package must be in `DRAFT` status.

## Request body

- object
  - `duration` string: Time span expressed as [vercel/ms](https://github.com/vercel/ms), with only string values accepted. There is a minimum of 5 mins and maximum of 1 year. (E.g. "2 days", "10h", "7d", without an time units, the default is milliseconds, i.e. "120" equals "120ms" )
  - `preparationConfig` ESignaturePreparationConfig
    - `enforcedAllowedSteps` ESignaturePreparationStepsEnum[]: Steps that the user will be allowed to perform. If not provided, the user will be allowed to perform all steps.
    - `enforcedAllowedKinds` union[]: Types of eSignature packages that the user will be allowed to create. If not provided, the user will be allowed to create/modify all types of eSignature packages.
      - union
        - 'IN_PERSON' | 'LIVE' | 'STANDARD'
        - 'RON' | 'IPEN'

## Response `200`

Secure link that can be used to send the request for eSignatures

- object
  - `url` string, required
  - `shortUrl` string, required

---

[API](https://skmtc.dev/pactima/apis/esignature-packages-api.md) - [All operations](https://skmtc.dev/pactima/apis/esignature-packages-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pactima/apis/esignature-packages-api/revisions/263938e87b8b?raw)