Quickstart guide
Send your first document
in 5 minutes
Three API calls: create a document, send it for signing, retrieve the signed PDF. Everything is REST + JSON — no SDK required, though one is available at @signvoy/node.
Get an API key
Open the Signvoy dashboard, navigate to Workspace Settings → API Keys, and click Create key. Copy the key — it is shown only once.
export SIGNVOY_API_KEY="sk_live_your_key_here"Create a document
You need a published template first. Create one in the dashboard or via POST /v1/templates. Then create a document from it:
curl -X POST https://api.signvoy.com/v1/documents \
-H "Authorization: Bearer $SIGNVOY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"templateId": "your-template-uuid",
"name": "Q3 2026 Service Agreement",
"recipients": [
{
"roleKey": "client",
"name": "Acme Corp",
"email": "legal@acme.com"
}
]
}'DocumentDto object. Save the id— you'll use it in the next step.Send for signing
Sending transitions the document from draft to sent and emails each recipient their unique signing link.
curl -X POST https://api.signvoy.com/v1/documents/$DOCUMENT_ID/send \
-H "Authorization: Bearer $SIGNVOY_API_KEY"Recipients receive an email with a unique link. They sign in their browser — no account required.
Retrieve the signed PDF
Poll the document status or listen for the document.completed webhook event. When status is completed, download the signed PDF:
# Check status
curl https://api.signvoy.com/v1/documents/$DOCUMENT_ID \
-H "Authorization: Bearer $SIGNVOY_API_KEY"
# Get presigned download URL (when status === "completed")
curl https://api.signvoy.com/v1/documents/$DOCUMENT_ID/signed-pdf \
-H "Authorization: Bearer $SIGNVOY_API_KEY"
# → { "url": "https://..." }The presigned URL is valid for 10 minutes. Use it to download the PDF or serve it directly to your user.
Stop chasing signatures
Join thousands of teams using Signvoy to close deals, onboard clients, and sign contracts — faster.
No credit card · Free forever plan · 14-day Pro trial
