Create an API Key
To use the Voidr API, you need a Service Account with clientId and clientSecret.
Steps
- Access app.voidr.co/settings
- In the Integrations section, click API Keys → Manage
- Click Create Service Account
- Fill in the name (e.g.,
CI/CD Pipeline) and optional description
- Copy and save the
clientId and clientSecret displayed
The clientSecret will not be shown again. Store it in a secure location.
What You’ll Receive
After creating a service account, you’ll get:
- clientId: Starts with
sa_ (e.g., sa_xxxxxxxxxxxxxxxx)
- clientSecret: Starts with
sk_ (e.g., sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx)
Next Steps
Use these credentials to authenticate via API and obtain a bearer token for making API requests.
Best Practices
- Store credentials securely in environment variables or a secrets manager
- Use separate service accounts for different environments (staging, production)
- Rotate credentials periodically
- Never commit credentials to version control
