Skip to main content
The Demomatic API uses API keys for authentication. Include your key in every request as a Bearer token in the Authorization header.
API access requires a Starter or Growth subscription plan. Requests from accounts on other plans receive a 403 Forbidden response.

​
Get an API key

Create an API key in your account settings:
1

Open Settings

Navigate to Settings > API Keys in the Demomatic dashboard.
2

Create a new key

Click New API Key, give it a name, and choose a permission level.
3

Copy the key

Copy the key immediately — it is only shown once. Store it securely (for example, as an environment variable).
Your API key is a secret. Never commit it to source control or expose it in client-side code.
For more details on managing keys, see the API Keys guide.

​
Permission levels

Each API key has one of two permission levels: Use read_only keys when you only need to read data (for example, fetching video lists or stats). Use all_access keys when you need to generate or delete videos.

​
Authenticate a request

Pass your API key as a Bearer token in the Authorization header:

​
Error responses

See Errors for full details on error response shapes.