Sign a Signature Request

Sign a Signature Request on behalf of a given Signer.

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 --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'
Language
Authorization
Bearer
URL
Click Try It! to start a request and see the response here!