Create API keys, choose what they can do and keep them safe.
Every request carries an API key. The key tells Spreadu which lab is asking, whether it's a test or a live request, and what it's allowed to do.
Put it in the Authorization header:
GET /api/print-lab/v1/me HTTP/1.1
Host: api.spreadu.com
Authorization: Bearer <your-api-key>That's the only way in. Session cookies don't work here, and billing credentials are a separate thing that can't be used with this API.
Copy a new key the moment it's shown. Spreadu can't show it again. Store it in your application's secret storage, never in a public page or a browser bundle.
409 WEBHOOK_URL_EXISTS.spreadu_lab_test_, live
keys begin spreadu_lab_. Both use the same base URL, and neither can see
the other's exports.Modules are the building blocks a lab has switched on.
core is always on. It covers GET /me, the event feed and webhook
management.exports covers everything around albums: reading, downloading, receipts
and confirmation. For your live lab, Spreadu switches it on separately.sandbox covers the simulator.Your test environment gets exports and sandbox automatically.
A few module names are reserved for later: catalog, prices, albums,
orders and customers. They aren't available in v1. Covers will arrive as
parts of exports, not as a module of their own.
Each key has at least one scope from the lab's enabled modules:
| Scope | What it allows |
|---|---|
exports:read | Read exports and export events. |
exports:download | Request download URLs and record receipts. |
exports:confirm | Confirm an order and release a lab lock. |
webhooks:manage | Create and manage the key's own webhook endpoints. Part of core. See Manage webhooks with an API key. |
sandbox:manage | Generate test exports and simulate corrections, withdrawal, order changes, warnings, expiry and reset. Part of sandbox, Test mode only. |
When you create a key, pick a preset or choose scopes one by one:
exports, it's selected by
default.A key can never reach into a module your lab doesn't have switched on.
For the API to answer at all, Spreadu's global API switch and your lab's API access both have to be on.
webhooks:manage manages only the endpoints it created itself.Allow analytics to help us improve these docs? We measure page visits and outgoing links. No session recordings. Privacy policy