---
updatedAt: 2026-08-27T13:52:09.000Z
agentTools:
  projectIndex: https://docs.youlend.com/llms.txt
---

# Sign a loan document via ‘instant signing’.

This endpoint allows you to electronically sign an agreement 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).

> 📘 Good to know
>
> We have an [updated endpoint](https://docs.youlend.com/reference/post_leads-leadid-clicksigndocuments) for this request, which we recommend using instead

This endpoint allows some partners to electronically sign an agreement inside a partner owned user interface.

Using this endpoint requires approval from YouLend. Please contact your integration or account manager if you would like to know more about solutions using this endpoint.

# 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}/clicksignloandocument": {
      "post": {
        "tags": [
          "Offers and Signing"
        ],
        "summary": "Sign a loan document via ‘instant signing’.",
        "description": "This endpoint allows you to electronically sign an agreement 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",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "api-version",
            "in": "header",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "description": "Model for the signature details.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ClickSignModel"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/ClickSignModel"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/ClickSignModel"
              }
            }
          }
        },
        "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": {
      "ClickSignModel": {
        "required": [
          "documentId",
          "leadId",
          "verificationId"
        ],
        "type": "object",
        "properties": {
          "leadId": {
            "minLength": 1,
            "type": "string",
            "description": "Gets or sets the LeadId.",
            "format": "uuid"
          },
          "documentId": {
            "minLength": 1,
            "type": "string",
            "description": "Gets or sets the DocumentId corresponding to the document the merchant wishes to sign.",
            "format": "uuid"
          },
          "verificationId": {
            "minLength": 1,
            "type": "string",
            "description": "Gets or sets an identifier for the merchant who signs the document."
          }
        },
        "additionalProperties": false,
        "description": "Model containing the signing details."
      },
      "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"
    }
  ]
}
```