Quickstart
Create a key, read your documents, and get called when one is signed.
Create an API key
In Signello, go to Settings → Integrations → API & Webhook → Create key.
The key is shown once. Copy it straight into wherever you keep secrets. We store only a hash of it and can never show it again. If you lose it, revoke it and create a new one. A workspace can have up to 10 active keys, so give each integration its own and revoke them one at a time.
A key reads every document in the workspace. Never put it in client-side code, in a browser app, or in a public repository.
Make your first call
Pass the key as a bearer token.
curl https://www.signello.se/api/v1/documents \
-H "Authorization: Bearer sgl_live_yourKeyHere"{
"ok": true,
"data": [
{
"id": "0f8d3a12-6c4e-4b7a-9f21-3d5e8c1a7b40",
"title": "Quote – roof replacement, Villa Ekhagen",
"status": "signed",
"url": "https://www.signello.se/p/8kQ2mXvR",
"createdAt": "2026-09-01T09:12:00.000Z",
"sentAt": "2026-09-03T08:14:22.000Z",
"signedAt": "2026-09-03T09:02:41.000Z",
"expiresAt": "2026-09-17T08:14:22.000Z",
"value": { "amount": 184500, "currency": "SEK" }
}
],
"nextCursor": null
}Documents come back newest first. Add ?status=signed to filter, ?limit=100
to take bigger pages, and see Conventions for how to page
through the rest.
Fetch one document in full
GET /documents/{id} returns the same object plus its recipients and its event
history, so you can see who has signed and when each of them opened it.
curl https://www.signello.se/api/v1/documents/0f8d3a12-6c4e-4b7a-9f21-3d5e8c1a7b40 \
-H "Authorization: Bearer sgl_live_yourKeyHere"Get events instead of polling
To know when a document is signed, you do not have to keep asking. Register a webhook and we call you instead.
curl https://www.signello.se/api/v1/webhook-endpoints \
-H "Authorization: Bearer sgl_live_yourKeyHere" \
-H "Content-Type: application/json" \
-d '{
"url": "https://yourcompany.com/webhooks/signello",
"events": ["document.signed", "document.completed"],
"description": "CRM sync"
}'The response contains secret, and that is the only time you will see it.
Store it now: it is what proves a delivery came from us. Read
Webhooks next.
Common errors
| Error | What it means |
|---|---|
invalid-api-key | The key is missing, mistyped or revoked. |
plan-required | The workspace is not on Max. |
rate-limited | You are calling too fast. Check the Retry-After header. |
The full list is in Conventions.