Quickstart guide

Send your first documentin 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.

Signvoy account (free)
An API key
curl or Node 18+
1

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.

terminal
export SIGNVOY_API_KEY="sk_live_your_key_here"
2

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
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"
      }
    ]
  }'
Response: a DocumentDto object. Save the id— you'll use it in the next step.
3

Send for signing

Sending transitions the document from draft to sent and emails each recipient their unique signing link.

curl
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.

4

Retrieve the signed PDF

Poll the document status or listen for the document.completed webhook event. When status is completed, download the signed PDF:

curl
# 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