Signer
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 Youtrust's pre-made signing flow).
To use this endpoint, you must match the following conditions:
- The Signature Request delivery_mode must be set to none.
- The Signature Request must not have any Approver, Signer Document Request or Signer Consent Request.
- The Signature Request must not have the parameter signers_allowed_to_decline set to true.
- The signature level must be "Simple eSignature".
Related guide: Building your own signing flow
ℹ️ This endpoint accepts two request body formats — pick the one that matches your use case:
- 📝 application/json — sign without uploading a signature image.
- 📁 multipart/form-data — upload a signature image alongside the consent payload.
🔓 Endpoint access
- Environments: production, sandbox
- API key scopes: organization, workspace
- Plans: scale
- Add-ons (for production access): none
post/signature_requests/{signatureRequestId}/signers/{signerId}/sign
Path parameters
signatureRequestIdstring uuid required
The unique identifier for a resource.
Example:9a93d3b5-fb3b-4abf-9e70-26315b33506c
Signature Request Id
signerIdstring uuid required
The unique identifier for a resource.
Example:9a93d3b5-fb3b-4abf-9e70-26315b33506c
Signer Id
Request body
Example request
{
"otp": "231457",
"ip_address": "192.0.2.146",
"consent_given_at": "2024-01-18T22:00:00Z"
}Response
No Content