API Authentication
How to authenticate with the AskBiz API using Bearer tokens. Generating your API key, token security, and rotating credentials.
Generating Your API Key#
1. Go to Account Settings โ Developer โ API Keys
2. Click Generate New Key
3. Give the key a descriptive name (e.g. 'Slack Bot', 'Internal Dashboard')
4. Copy the key immediately โ it's shown in full only once
5. Store it securely (environment variable, secrets manager โ never in source code)
Using the Token#
Include your API key in the Authorization header of every request:
```
Authorization: Bearer your-api-key-here
```
Example curl request:
```
curl https://api.askbiz.co/v1/pulse \
-H 'Authorization: Bearer your-api-key-here'
```
Key Security Best Practices#
- Never commit API keys to Git โ use environment variables
- Use one key per integration โ makes it easy to revoke a single integration without affecting others
- Rotate keys every 90 days โ generate a new key, update your integration, then revoke the old one
- Monitor usage โ the Developer page shows request volume per key; unusual spikes may indicate a leaked key
Revoking a Key#
If a key is compromised or no longer needed, go to Account Settings โ Developer โ API Keys and click Revoke next to the key. Revocation is immediate โ all requests using that key will return 401 Unauthorized.
Frequently Asked Questions
Was this article helpful?
Still stuck? Email our support team.