# Setting Up IPQualityScore Proxy Detection Webhook

> The IPQualityScore Proxy integration analyzes visitor IP addresses in real-time to detect proxies, VPNs, Tor, and other high-risk IP addresses.

Source: https://callgrid.com/knowledge-base/setting-up-ipqualityscore-proxy-detection-webhook
Last updated: 2025-09-24
Topics: Integrations, Data Collection

The IPQualityScore Proxy integration analyzes visitor IP addresses in real-time to detect proxies, VPNs, Tor connections, and other high-risk IP addresses, providing fraud scoring and reputation data to improve call quality and security.

## Prerequisites

Before setting up your webhook, you'll need:

- An active IPQualityScore account
- API key from your IPQualityScore dashboard
- Premium account access for advanced proxy detection features

## Setup Process

### 1. Get Your API Key

1. Log into your IPQualityScore account
2. Navigate to your account settings or dashboard
3. Find the API section and copy your API key
4. Ensure your account has IP reputation query credits available

### 2. Create New Webhook

1. Navigate to **Integrations** → **Webhooks**
2. Click **+ New Webhook**
3. Select **Data Collection** template type
4. Choose **IPQualityScore Proxy** from the dropdown

### 3. Basic Configuration

![](https://callgrid.com/api/media/file/ipqTemplate.png)

1. **API Key**: Enter your IPQualityScore API key
2. **Name**: Give your webhook a name
3. **Event**: Select **Call Completed**
4. Click **Save Webhook**

### 4. Advanced Options

After saving, you can configure additional settings:

![](https://callgrid.com/api/media/file/ipqconfig.png)

**Dynamic Variables** The system automatically maps call data to IPQualityScore IP analysis:

- VisitorIpAddress maps to the IP parameter for reputation analysis

**Request Structure** The webhook sends a GET request to IPQualityScore's API with:

- IP address for proxy detection and reputation scoring
- Your API key for authentication
- Request for comprehensive fraud and risk analysis

**Filtering**

![](https://callgrid.com/api/media/file/ipqfilter.png)

- Add filters using any system tag (InboundState, BuyerName, CampaignName, etc.)
- Use **Equals** conditions to control when IP analysis occurs
- Combine conditions with **Add Or Rule** or **Add And Rule**

**Value Extraction** After running a webhook test to discover response properties:

![](https://callgrid.com/api/media/file/ipqValue.png)

1. Select response properties like fraud_score, proxy, vpn, tor, abuse_velocity, etc.
2. Map them to custom tags for advanced routing and risk assessment
3. Use extracted data to automatically filter high-risk IP addresses
4. Route calls based on IP reputation scores and connection types

**Testing**

![](https://callgrid.com/api/media/file/ipqtest.png)

- Fill in test values for VisitorIpAddress (use a real IP address)
- Click **Run Webhook** to verify the integration
- Review the response data to see reputation results and available properties

## Best Practices

- Monitor your API usage and credit consumption
- Set up value extraction to capture key reputation metrics
- Use fraud scores and proxy detection for call routing decisions
- Test with various IP types to ensure proper detection
- Configure filtering to avoid unnecessary API calls for trusted IP ranges

## Troubleshooting

- Verify your API key is active and has sufficient credits
- Ensure IP addresses are in the correct format for analysis
- Check that your IPQualityScore account has proxy detection enabled
- Monitor API response times and adjust timeout settings if needed
- Review IPQualityScore documentation for specific error codes

The integration enables real-time IP reputation analysis and proxy detection, helping you automatically identify and route calls based on visitor IP risk scores, connection types, and abuse history to prevent fraudulent activity and improve call quality.