Skip to main content
z3nkarun
New Voice
New Voice
January 13, 2025
Solved

SenderView - Do I create a SenderView Preview URL everytime ? or retain url

  • January 13, 2025
  • 2 replies
  • 154 views

Hi Team, 

Working on an integration utilizing template and sending an envelope. Before sending I want to generate a preview url. This preview url is different everytime I hit the api. How long does this preview url lasts? whats the best practice on generating sender views? 

Should I retain the generated url until the envelope is sent ? 


Sender API

 

Regards, 

Karun

Best answer by Sai.Dandamudi

Hello 

The Sender View Preview URL generated through the DocuSign API is a temporary, one-time-use URL that is unique every time it is created. These URLs typically expire after five minutes or as soon as they are accessed. Therefore, it is not recommended to retain the generated URL until the envelope is sent, as it may expire before being used. The best practice is to generate the Sender View URL only when the sender is ready to access the envelope for preview or editing. Since the URL is intended for immediate use, it should not be stored or reused .

https://developers.docusign.com/docs/esign-rest-api/reference/envelopes/envelopeviews/createsender/

Thankyou

Sai

2 replies

Docusign Employee
January 14, 2025

Hello 

The Sender View Preview URL generated through the DocuSign API is a temporary, one-time-use URL that is unique every time it is created. These URLs typically expire after five minutes or as soon as they are accessed. Therefore, it is not recommended to retain the generated URL until the envelope is sent, as it may expire before being used. The best practice is to generate the Sender View URL only when the sender is ready to access the envelope for preview or editing. Since the URL is intended for immediate use, it should not be stored or reused .

https://developers.docusign.com/docs/esign-rest-api/reference/envelopes/envelopeviews/createsender/

Thankyou

Sai

z3nkarun
New Voice
z3nkarunNew VoiceAuthor
New Voice
January 15, 2025

hi ​@Sai.Dandamudi  I have additional question.

I opened this preview url in an iframe within same window. Can I receive messages on my window where I opened an Iframe within my app. [I dont want create a seperate page to handle the redirect and then create a postmessage to window.parent as suggested in the docs]

I opened this generated preview url and plugged into an iframe. Also registered for window.addeventListener(“message”, handler) in my component where I am setting preview Url. I was hoping I would receive different messages like  envelope “sent” event and other events but this doesnt seem to work. 

Would you help me with the best practise. 


I also came across this doc mentioning docusign js which is what I was inferring when talking above. But this doesnt seem to work for SenderView ?