Create signature request from template
Creates a draft signature request from an Active template.
POST https://cotlet.dev/api/v1/yousign/templates/{template_id}/signature-requests
write
Returns the draft with its ID, signers and filled fields. It fails when a placeholder role has no signer or a Read-only Text field is still empty. The draft reaches no one: signers are emailed only when you call send_signature_request, so this tool does not ask for confirmation.
Parameters
| Name | Type | Description |
|---|---|---|
| template_id string required | string | Template ID from list_templates. The template must be Active. |
| name string | string | Name of the request. Leave out to use the template name. |
| signers array required | array | One object per placeholder signer: role (the role name in the template), first_name, last_name, email. |
| text_fields object | object | Values for the empty Read-only Text fields of the template, keyed by field name. |
Request
curl -X POST https://cotlet.dev/api/v1/yousign/templates/template_8c41d2/signature-requests \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"signers":"signers"}'result = client.call("yousign", "create_signature_request", {"template_id":"template_8c41d2","signers":"signers"})const result = await cotlet.call('yousign', 'create_signature_request', {"template_id":"template_8c41d2","signers":"signers"});cotlet call yousign create_signature_request --data '{"template_id":"template_8c41d2","signers":"signers"}'Example response
{
"id": "3f6b1c2e-8a41-4d7c-9b5e-2a0f6d1c7e90",
"name": "Freelance agreement",
"status": "Draft",
"signers": [
{
"role": "Contractor",
"name": "Ana Lopez",
"email": "ana@example.com"
}
],
"text_fields": {
"monthly_fee": "2,400 EUR"
}
}