You can generate an
idonly for documents in the
sent, waiting for payment, paid, and completedstatuses. In order to move a document to the
sentstatus without actually sending any emails to recipients, use the Send Document endpoint with the
If a document is in "waiting_approval", "rejected", or "declined" status, you can't use Share Document call. Share Document endpoint will return HTTP 400 with an error.
Generating a Document Link from the returned
idthis endpoint returns is a session id. Use this URL format to view a document:
When generating a document link, first we must request a
session ID per the session endpoint above. Once the
session ID is generated, it can then be placed in the URL format above for sharing.
We see the
lifetimeparameter often overlooked when generating a
session ID. Make sure that you provide a
lifetimevalue in seconds that is great enough for the recipient(s) to complete the shared document. We recommend values under 1 year for security purposes, e.g.: