Authentication
All API requests must be authenticated using an API key.
Using Your API Key
Include your API key in the X-API-Key header with every request:
curl -H "X-API-Key: pb_live_your_key_here" \https://api.parsebounce.com/projects/{projectId}/suppressions
Getting an API Key
1. Go to your Profile page
2. Scroll down to the API Keys section
3. Click Create Key and give it a name
4. Copy the key immediately — it's only shown once!
Important: API access requires a Startup or Business plan. Free plan users cannot create API keys.
API Key Format
API keys start with pb_live_ followed by 32 random characters:
pb_live_TMM-A37k9h92GG6sImC-AyNc8jU5xven
Security Best Practices
- Never commit API keys to version control
- Use environment variables to store keys
- Only call the API from server-side code, not from browsers
- Revoke and regenerate keys if they may have been exposed
- Use separate keys for development and production
Authentication Errors
401 UnauthorizedInvalid or missing API key
{"error": "Unauthorized"}
403 ForbiddenAPI key doesn't have access to this project
{"error": "Unauthorized"}