API keys, headers and environments.
Authentication
All API requests require a Bearer token.
Header
Authorization: Bearer YOUR_API_KEY
Key prefixes
| Prefix | Environment |
|---|---|
ad_live_ | Production |
ad_test_ | Sandbox |
Creating keys
- Dashboard → API keys
- Create key — choose a label
- Copy the secret immediately (shown once)
- Revoke unused keys from the same page
Scopes
Keys inherit your plan. Builder keys can only hit the one source on your plan. Pro and Enterprise keys can hit all live and beta sources.
Never embed live keys in public repos or client-side apps.