Creating and revoking API keys

An API key lets an automation tool like Zapier, Make or n8n, or even your own scripts, send deliveries from your Veluril library for you. It takes a few seconds to create one. For security, we recommend generating one key for each tool or script you connect.

Creating a key

Head to your API keys page. Give the key a recognizable name so you know which is which in the future, and click the "Generate key" button:

The Keys card on the API keys page, with Zapier typed as the name and the Generate key button highlighted

Copying your secret key

Your new key appears in the yellow box. Click "Copy key", and save it securely, preferably in a password manager or similar, then click "I have copied it":

The new Zapier key shown once, with the Copy key button highlighted and the I have copied it button beside it

This is the only time we can show you the key. We don't store the key itself, so no one can read it back, not even us. If you lose it, just generate another.

Treat the key like a password. Anyone who has it can work in your library, sending deliveries, adding content and changing bundles, so paste it only into the tool or script it's for.

Checking the key is working

Every key is listed on your API keys page. A key shows "Not used yet" until it receives its first request. Then it shows "Active", with when it was last used:

Two keys on the API keys page, Make marked Not used yet and Zapier marked Active, last used 14 minutes ago

If you've sent a test and the key still says "Not used yet", check the whole key was pasted into your tool or script.

Revoking a key

When you stop using a tool or script, or think its key has been shared, click "Revoke" beside the key and confirm with "Revoke key":

The Revoke Zapier popup, saying anything using the key stops working immediately, with the Revoke key button highlighted

Anything using that key stops working straight away. Your other keys keep working, and your bundles, files and deliveries aren't touched. A revoked key can't be switched back on, so if you need the original tool or script to keep working, generate a new key for it.

With the key in place, you'll need to know which bundle to deliver.

Next → Finding a bundle's ID