Authentication

Learn how to authenticate your API requests using API keys.

Getting an API Key

  1. Go to your project settings
  2. Click on the "API" tab
  3. Click "Create API Key"
  4. Copy and securely store your key
Important: Your API key is only shown once. Store it securely and never expose it in client-side code.

Using Your API Key

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

Authorization: Bearer your_api_key_here

Example Request

curl -X GET "https://premonize.com/api/v1/waitlist/subscribers" \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxx" \
  -H "Content-Type: application/json"

Permissions

API keys can be scoped to limit access:

Scope Description
waitlist:read Read waitlist subscribers and stats
waitlist:write Add and remove subscribers
changelog:read Read changelog posts
changelog:write Create and update posts
feedback:read Read feedback items
feedback:write Create and update feedback

Authentication Errors

401 Unauthorized

{
  "success": false,
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key"
  }
}

403 Forbidden

{
  "success": false,
  "error": {
    "code": "forbidden",
    "message": "API key does not have required permissions"
  }
}

Was this page helpful?

Your feedback helps us improve our documentation

Thank you for your feedback!

Your input helps us create better documentation for everyone