API Key Management

Create and manage API keys for programmatic access

Creating an API Key

  1. Navigate to Settings → API Keys
  2. Click Create New API Key
  3. Enter a descriptive name
  4. Set permissions (read-only, read-write, admin)
  5. Click Generate Key
  6. Copy and store the API key securely (it won't be shown again)

API Key Permissions

  • Read-Only: View aliases, domains, and logs
  • Read-Write: Create, update, and delete resources
  • Admin: Full access including account settings

Using API Keys

Include your API key in requests:

curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://msgs.global/api/v1/aliases

Managing API Keys

  • View Usage: See when each key was last used
  • Rotate Keys: Generate new keys and revoke old ones
  • Set Expiration: Keys can expire automatically
  • Delete Keys: Revoke access immediately

Security Best Practices

  • Never commit API keys to version control
  • Use environment variables to store keys
  • Rotate keys regularly (every 90 days)
  • Use read-only keys when possible
  • Delete unused keys immediately
← Back to Documentation Web Docs Index →