Brandwave/Docs

Authentication#

API key authentication

Brandwave API keys authenticate server-side integrations, automation, and AI tools. Create and manage keys from your workspace settings.

Include your API key in the Authorization header of every request.

Getting your API key#

API keys are managed in your workspace settings. Each key is scoped to a single workspace and inherits the permissions of the user who created it.

  1. Sign in to your Brandwave dashboard
  2. Navigate to Workspace Settings
  3. Select the API Keys tab
  4. Click Create API Key and give it a descriptive name

Keep your key secret

API keys grant full access to your workspace's data. Never commit them to version control, expose them in client-side code, or share them publicly.

Using your API key#

Pass your API key as a Bearer token in the Authorization header.

bash
curl https://api.gobrandwave.com/v1/activities \
  -H "Authorization: Bearer bw_live_abc123def456"

Error responses#

Authentication errors return a 401 Unauthorized status with a JSON error body.

json
{
  "error": "unauthorized",
  "message": "Invalid or expired API key."
}

Common causes#

  • Missing Authorization header
  • Incorrect key format (must start with bw_live_)
  • Revoked or expired API key
  • Key does not belong to the requested workspace