v1

latestOpenAPI 3.0.0proprietary2026-07-261695971.5 MB
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

otpstring nullable
consent_given_atstring date-time required

UTC date. Must be in format 2024-01-18T22:00:00+00:00

Example request

{
  "otp": "231457",
  "ip_address": "192.0.2.146",
  "consent_given_at": "2024-01-18T22:00:00Z"
}

Response

No Content