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:
PermissionAllowed methods
read_onlyGET only
all_accessGET, POST, PUT, DELETE
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: 
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.demomatic.tech/v1/videos

​
Error responses

ScenarioStatus
Authorization header is missing or malformed401 Unauthorized
API key is invalid or does not exist401 Unauthorized
Key has read_only permission but request uses a write method401 Unauthorized
Account plan does not include API access403 Forbidden
See Errors for full details on error response shapes.