Create and rotate API credentials

If you want to send orders to Printeers from your own system, you authenticate against our REST API with an API key. You create and manage these keys yourself in the Dashboard.

Create an API key

Open API credentials and select Create key. Give the key a recognisable name (for example the name of the system or environment that will use it) and confirm.

We then show you the secret key once. Copy it straight away and store it somewhere safe, such as a password manager or your platform's secrets store. For security we never show the full secret again, so if you lose it you will need to create a new key.

Find your keys

The API credentials page lists every key with its name, reference, creation date and status. The reference is a short identifier you can use to recognise a key; it is not the secret itself. Use the View docs button to jump straight to the API reference.

Rotate a key

To rotate a key, create a new one, update your integration to use the new secret, and then revoke the old key. Doing it in that order means your orders keep flowing while you switch over.

Revoke a key

Select Revoke next to a key and confirm. The key stops working immediately, so only revoke a key once nothing is using it any more. Revoked keys stay in the list with a revoked status for your records.

Keep your secret safe

• Treat the secret key like a password and never commit it to source control or share it in plain text.
• Use a separate key per integration or environment so you can revoke one without affecting the others.
• If you suspect a key has leaked, revoke it and create a fresh one.

For details on the endpoints and how to authenticate, see our integrations overview.