API reference
API docs
Get started
Guides
Endpoints
Account
Templates
Sending
Documents
Files
OpenAPI
Reference
Inkly API reference
Every endpoint in the REST API, each on its own page with request examples, response fields, and the errors it can return.
Basics
The base URL is https://www.inkly.so/api/v1. Requests need an API key from a Pro or Teams workspace, which you create on API settings.
There is no test mode. Every document you create is real and legally binding, counts toward your allowance, and sends completion copies.
delivery: "link" only skips the invitation email, so it is not a sandbox. To try things out, send to your own email address.- AuthenticationSend a bearer key, and see what each kind of key can do.
- Requests and responsesJSON bodies, unknown fields, pagination, and request IDs.
- IdempotencyRetry a send safely, without creating a second document.
- LimitsThe monthly allowance, rate limits, and file sizes.
- ErrorsThe error body, and every code by HTTP status.
- WebhooksEvents, payloads, signatures, retries, and duplicates.
Account
Check which workspace a key belongs to and how much of the monthly allowance is left.
Templates
Find a template and the roles you need to fill to send it.
Sending
Send a document from a template or from a PDF you upload. Both create a real, legally binding document.
Documents
Files
Download what a completed document produced. Links work for 5 minutes, so fetch a new one each time.
OpenAPI
This API description, as a machine-readable document.