GET /v1/recipients/:id/token
{
  "endpoint": "https://annature..",
  "expiration": "2019-12-17T05:30:00Z"
}

Generates a new signing token that can be used to access the envelope in the context of a specific recipient. If the recipient has already completed their required actions, the token will provide read-only access to view and download the finalised documents.

This endpoint is typically used in workflows where the application needs to manage the delivery of signing links manually — especially for muted recipients.

If a recipient attempts to access an envelope using an expired signing token, they may choose to request a new one from Annature. When the recipient is not muted, a new email or SMS will be sent based on their selected method. If the recipient is muted, no communication will be sent and a recipient_token_request webhook event will be triggered instead. You must listen to this event and handle link distribution yourself.

Parameters

token_duration
optional

The number of days the generated token should remain valid. Must be between 1 and 30 days. Default is 7 days.

GET /v1/recipients/:id/token
{
  "endpoint": "https://annature..",
  "expiration": "2019-12-17T05:30:00Z"
}