Sign a Signature Request

Use this endpoint if you are integrating your own signing flow (Signers won't go through Yousign's pre-made signing flow).

Related guide: Building your own signing flow

🚧

To use this endpoint, you must match the following conditions:

• You are in free API Trial period or you are on a SCALE plan
• The Signature Request delivery_mode must be set to none
• The Signature Request must not have any Approver
• The Signature Request must not have the parameter signers_allowed_to_decline set to true
• The signature level must be "Simple eSignature".
• No Signer Fields can be used, except the Signature Field

📘

You can send a custom Signature Image

If you want to send a Signature Image in pdf format, you must change content-type to multipart/form-data, and add in body param: signature_image='@my_File.pdf'

Example below:

Curl

> 📘 curl --request POST  
>      --url https://api-sandbox.yousign.app/v3/signature_requests/{signatureRequestId}/signers/{signerId}/sign
>      --header 'accept: application/json'  
>      --header 'content-type: multipart/form-data'  
>      --form ip_address=2001:0000:130F:0000:0000:09C0:876A:130B  
>      --form 'consent_given_at=2024-01-18T22:00:00+00:00'  
>      --form signature_image='@my_file.pdf'