Referenceadvancedadmin
Environment Variables Reference
All supported environment variables for agent configuration.
3 min read3,700 viewsUpdated 2026-07-10
Recommended variables
The API itself needs only your key; these are the conventional names to keep your integration configurable:
| Variable | Required | Description |
|---|---|---|
BOTONOM_API_KEY | Yes | Your bk_live_ key (identifies your workspace - no separate workspace id is needed) |
BOTONOM_API_BASE | No | API base URL; defaults to https://api.botonom.com/en/api/v1 |
BOTONOM_WEBHOOK_SECRET | No | Your whsec_ signing secret, for verifying incoming webhook deliveries |
# .env example
BOTONOM_API_KEY=bk_live_abc123...
BOTONOM_API_BASE=https://api.botonom.com/en/api/v1
BOTONOM_WEBHOOK_SECRET=whsec_def456...
Never commit your
.env file to version control. Use a secrets manager in production, and rotate keys from Dashboard → Developers → Credentials (create the new key first, then revoke the old one).configenvironmentreference
Was this helpful?
More questions? Contact support