It’s now possible to add Followers while the Signature Request status is draft
.
Followers will receive an email when the Signature Request is activated or when it is created on a Signature Request that has already been sent.
It's now possible to override the delivery mode for one Signer.
Why? When you have several Signers, it is now possible to define different delivery modes for each signer. This way, one signer is able to sign face-to-face while the other Signer receives an email with the signature link sent by Yousign.
It is still requested to define the delivery mode at the Signature Request level.
The delivery mode set at the level of the Signature Request is applied for all Signers. If you want a different delivery mode for one or several signers, you can override it for the concerned signers and it will be applied for them.
Using the delivery mode email, you can now retrieve the link of the Signature request when you activate it. As well as for the delivery mode none, it is in the payload of the answer.
When a Signature Request is activated or when a GET /Signer request is done, the Signature Link is included in the response payload. The Signature Link's expiration date is now included.
{
"id": "ee1d9413-ce72-4c25-a294-fcf20cf34a26",
"status": "ongoing",
"name": "The name of your Signature Request",
"created_at": "2023-01-03T10:40:00+00:00",
"email_custom_note": "",
"ordered_signers": false,
"timezone": "Europe/Paris",
"reminder_settings": null,
"expiration_date": "2023-07-03T21:59:00+00:00",
"signers": [
{
"id": "50c35490-bc04-493c-98da-7a0ac493744a",
"status": "notified",
"signature_link": "https://yousign.app/signatures/ee1d9413-ce72-4c25-a294-fcf20cf34a26?s=846991a748d97f86dd77az99ac23def97f8197ca0d93c2395b7&r=e8abd212f99bde967e37bb7deb4a3fdf&source=email&lang=fr&magic_link_id=b192a9f2-1071-4829-b2bc-d2a964402ec0&domain_id=c9cb0951a3&k=rnEV1JFOpbIWCtQ3gRcOAxXCkTMFxPfn",
"signature_link_expiration_date": "2023-05-05T09:28:57+00:00"
}
],
"approvers": [],
"documents": [
{
"id": "b9a7e6f1-c633-4305-b5b9-c36a592c0cb0",
"nature": "signable_document"
}
],
"delivery_mode": "none",
"external_id": null,
"custom_experience_id": null,
"sender": null
}
{
"id": "27b4bf2a-ea9d-49bd-b3bd-0994fa89c07f",
"info": {
"first_name": "John",
"last_name": "Doe",
"email": "[email protected]",
"phone_number": "+33700000000",
"locale": "fr"
},
"status": "notified",
"signature_link": "https://yousign.app/signatures/31fb6143-7d56-4a18-b1b1-1c641c02fd66?s=27b51f5d768861bea81ecdc8428e6deedce90936b7e59334cae4cfd6ee1759106cd78407d387e42dcc2fe70f3abbc7535b0eabc3624cc256bef928997170d2c7&r=d7cc980c7e0ae81df5fdfcfce9ab83ff&source=email&lang=fr&magic_link_id=4cdb4efb-8444-4dfc-a4e9-d426e3175eca&domain_id=4c52ed4612&k=JiBLPjes3UHySd9AImyVustBIXA67cGZ&sandbox=true",
"signature_link_expiration_date": "2023-05-05T09:28:57+00:00",
"signature_image_preview": "https://api-sandbox.yousign.app/signature_requests/31fb6143-7d56-4a18-b1b1-1c641c02fd66/recipients/27b4bf2a-ea9d-49bd-b3bd-0994fa89c07f/preview.8c1e958b7a4b98845d6cc1cf81c45341c2312161.svg",
"fields": [
{
"id": "ca4647f0-5afe-4b66-808d-0a6c5c1cdd9b",
"document_id": "b39677bf-86e6-421e-b44e-64ee8085862a",
"type": "signature",
"page": 1,
"x": 400,
"y": 650,
"width": 180,
"height": 37
}
],
"signature_level": "electronic_signature",
"signature_authentication_mode": "otp_sms",
"redirect_urls": {
"success": null,
"error": null
},
"custom_text": {
"request_subject": null,
"request_body": null,
"reminder_subject": null,
"reminder_body": null
}
}
If an Approver refuses to validate a Signature Request, it is possible for him to add a refusal reason. This value can be retrieved in theapprover.rejected
webhook's payload.
A new field exists! You can create the Radio Buttons Fields. It is an alternative to Checkbox fields if you only need to select one of several options.
It is possible to create them either with smart anchors or manually: https://developers.yousign.com/docs/fields-creation-new
You find the checkboxes too big for your document? It is now possible to choose the size of the checkbox fields. Make them fit your document size!
This option is available for smart anchors and manual fields creation:
Creating a checkbox without the size
parameter is now considered deprecated but you don't need to change anything in your code, it will still work and it is not planned to be suppressed.
All new integrations should add this size
parameter for checkbox creation.
Workspaces allow you to ensure the confidentiality of documents between your users or reflect the organization of your company (departments, subsidiaries, agencies...).
When you create a Signature Request you can choose to store it in a specific Workspace. Otherwise, the Signature Request will be stored in the oldest active workspace.
More details about Workspaces can be found here.
Electronic Seal allows a company (moral entity) to seal on a file without any signature request configuration..
New endpoints
https://developers.yousign.com/reference/post-electronic-seals
New events
In addition, two new webhook events are created:
Event | Description |
---|---|
electronic_seal.done | The document is stamped and the Electronic seal status is done |
electronic_seal.error | An error occurred during Document stamping and the Electronic seal status is in error |
A new event signer.error
is available. It notifies you when a Signer failed to sign due to an internal error during the signing process, in that case, the Signature Request is automatically cancelled.
This error can be due to a corrupted document for example.
If the error persists, don't hesitate to get in touch with your dedicated counsellor.