---
updatedAt: 2026-09-17T09:50:03.000Z
agentTools:
  projectIndex: https://docs.youlend.com/llms.txt
---

# Sign documents via 'instant signing'.

This endpoint allows you to electronically sign documents inside your own UI.
Using the endpoint requires approval from YouLend.
There are certain requirements you’ll need to meet for (a) how the signing flow is presented to the user, (b) how you manage logins and permissions, and (c) and what would count as a robust enough ‘verificationId’ (typically IP address and/or userId).

This endpoint allows you to electronically sign documents inside your own UI.

<br />

<Callout icon="📘" theme="info">
  ### Good to know

  For leads with more than one document - it is expected that all documents are provided in one call to this endpoint
</Callout>

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Onboarding",
    "description": "Through this API you can can initiate the process of onboarding a borrower with YouLend",
    "contact": {
      "name": "Mark Ufland",
      "email": "mark.ufland@youlend.com"
    },
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://partners.staging-youlendapi.com/onboarding"
    }
  ],
  "paths": {
    "/Leads/{leadId}/clicksigndocuments": {
      "post": {
        "tags": [
          "Offers and Signing"
        ],
        "summary": "Sign documents via 'instant signing'.",
        "description": "This endpoint allows you to electronically sign documents inside your own UI.\r\nUsing the endpoint requires approval from YouLend.\r\nThere are certain requirements you’ll need to meet for (a) how the signing flow is presented to the user, (b) how you manage logins and permissions, and (c) and what would count as a robust enough ‘verificationId’ (typically IP address and/or userId).",
        "parameters": [
          {
            "name": "leadId",
            "in": "path",
            "description": "The lead id.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "api-version",
            "in": "header",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "description": "Model for click signing documents.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ClickSignDocumentsModel"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/ClickSignDocumentsModel"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/ClickSignDocumentsModel"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              },
              "application/xml": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "ClickSignDocumentModel": {
        "type": "object",
        "properties": {
          "documentId": {
            "type": "string",
            "format": "uuid"
          },
          "verificationId": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "ClickSignDocumentsModel": {
        "type": "object",
        "properties": {
          "documentsToSign": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ClickSignDocumentModel"
            },
            "nullable": true
          }
        },
        "additionalProperties": false
      },
      "ProblemDetails": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "nullable": true
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "detail": {
            "type": "string",
            "nullable": true
          },
          "instance": {
            "type": "string",
            "nullable": true
          }
        },
        "additionalProperties": {}
      }
    },
    "securitySchemes": {
      "oauth2": {
        "type": "oauth2",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "https://youlend-stag.eu.auth0.com/oauth/token",
            "scopes": {}
          }
        }
      }
    }
  },
  "security": [
    {
      "oauth2": []
    }
  ],
  "tags": [
    {
      "name": "Offers and Signing"
    }
  ]
}
```