Environments

Environments in UserCheck allow you to separate your API usage across different stages of your development workflow. This feature helps you test integrations, manage different deployment stages, and maintain clean separation between your production traffic and development work.

What are Environments?

An environment is a way to logically separate your API usage, settings, and configurations. UserCheck supports three environments:

• Production - Your live, customer-facing application
• Staging - Pre-production testing environment
• Development - Local development and testing

Each API key belongs to a specific environment, and all requests made with that key are automatically associated with that environment. This ensures complete isolation between your different deployment stages.

Important: All environments use the same production API infrastructure and all requests count toward your shared monthly quota. Environments provide organizational separation, not infrastructure separation.

What Environments Separate

✅ Environment-Specific:

• Blocklist entries (domains blocked per environment)
• Webhook subscriptions and their configurations
• Usage analytics and logs
• API key organization

❌ Shared Across All Environments:

• API infrastructure (same endpoints)
• Monthly billing quota
• Rate limiting counters
• Account plan features
• Response data and functionality

How Environments Work

API Keys Determine Environment

Each API key belongs to exactly one environment. When you make a request, the environment is automatically determined by which API key you use - you don't need to specify the environment in your request.

Blocklists

Domain blocklists are environment-specific based on the API key used. A domain blocked using a production API key won't affect your development testing, and vice versa.

Webhooks

Webhook subscriptions are configured per environment, so you can:

• Send production webhooks to your live system
• Send staging webhooks to your testing infrastructure
• Send development webhooks to localhost or testing tools

Setting Up Environments

Create Environment-Specific API Keys

In your UserCheck dashboard:

1. Go to API Keys
2. Click Create New Key
3. Set the Name (e.g., "My App")
4. Select the Environment
5. Save the key