Most teams start integrations by sharing a powerful token. That works until it doesn't.
Start here:
Scope is about least-privilege, not bureaucracy
Scopes exist so you can say:
- This key can read vendors.
- This key cannot write purchase orders.
- This key can manage webhooks.
That is how you prevent "integration compromise" from becoming "tenant compromise."
Rate limits keep traffic predictable
Rate limits are not only for abuse. They also:
- protect production during bugs
- prevent runaway retry loops
- make third-party tooling safe to run continuously
If you want higher limits, raise them intentionally. Do not default to unlimited.
A practical key handoff checklist
When you give an external developer an API key:
- Issue the smallest scope set that still works
- Start with a standard rate limit tier
- Require rotation on a schedule (or on incident response)
- Ensure revocation is immediate and easy
- Monitor usage (last used + usage counts)
Where API keys and webhooks connect
Common pattern:
- Use API keys for configuration and controlled reads/writes
- Use webhooks for real-time event delivery
See also: