API Reference
Status PageRoadmapTestimoniesShare feedback

Create a new Approver

post
https://api-sandbox.yousign.app/v3/signature_requests//approvers

Adds an Approver to a given Signature Request.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

An Approver can be created:

  • from scratch
  • from an existing Contact
  • from an existing User
  • from an existing Signer

Limits: a maximum of 10 Approvers can be added per Signature Request.

Related guide: Approver

🔓 Endpoint access

  • Environments: production, sandbox
  • API key scopes: organization, workspace
  • Plans: plus, pro, scale
  • Add-ons (for production access): None
Path Params
uuid
required

Signature Request Id

Body Params

An Approver object to be added to the Signature Request.

Create a new Approver from scratch.

info
object
required
custom_text
object

Custom Text

uuid | null

ID of the recipient this one must follow in an ordered flow; they will only be asked to act after that recipient.
When custom_recipient_order is enabled, this can reference any approver or signer.
When custom_recipient_order is disabled, the referenced ID must be an approver. ordered_approvers must be enabled on the Signature Request.

uuid | null

ID of another recipient (Approver or Signer); both will be allowed to act in parallel in an ordered flow.
Only available when custom_recipient_order is enabled.

excluded_documents
array of uuids

List of Document IDs not visible to this Recipient. When omitted, the Recipient can see all Documents. Only available when the document_visibility feature is enabled on the organization.

excluded_documents
Responses

Updated about 1 month ago

Language
Credentials
Bearer
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 1 month ago