Skip to content

Authentication

API Key Authentication

For all programmatic access, authenticate by including your API key in the X-API-Key header.

Where to Find Your API Key

  1. Log in to Adwize at app.getadwize.com.
  2. Go to Settings > API Keys.
  3. Copy your API key.

Keep your API key secret

Your API key grants full access to your tenant's data. Never expose it in client-side code, public repositories, or browser JavaScript. Use it only in server-side applications or secure environments.

Example Requests

curl https://api.getadwize.com/api/v1/events/ \
  -H "X-API-Key: YOUR_API_KEY"

import httpx

response = httpx.get(
    "https://api.getadwize.com/api/v1/events/",
    headers={"X-API-Key": "YOUR_API_KEY"},
)
print(response.json())

const response = await fetch("https://api.getadwize.com/api/v1/events/", {
  headers: {
    "X-API-Key": "YOUR_API_KEY"
  }
});
const data = await response.json();

Error Responses

Status Meaning
401 Unauthorized API key is missing, invalid, or revoked
403 Forbidden API key is valid but the request domain is not in your allowed domains 
{
  "detail": "Invalid or missing API key"
}

Rotating Your API Key

To rotate your API key:

  1. Go to Settings > API Keys.
  2. Generate a new key.
  3. Update all your integrations with the new key.
  4. The previous key stops working immediately.

Web UI Authentication

The Adwize web application uses session-based authentication (JWT cookies) handled automatically by your browser after login. You do not need to manage this -- it is transparent when using the dashboard at app.getadwize.com.

Rate Limits

See the API Overview for rate limit details.