# Setting Up IPQualityScore Phone Number Validation Webhook

> The IPQualityScore integration validates phone numbers in real-time, providing fraud detection, carrier information, and reputation scoring.

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

The IPQualityScore integration validates phone numbers in real-time, providing fraud detection, carrier information, and reputation scoring to help identify high-risk numbers and improve lead quality.

## Prerequisites

Before setting up your webhook, you'll need:

- An active IPQualityScore account
- API key from your IPQualityScore dashboard
- Premium account access for advanced validation 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 phone validation credits available

### 2. Create New Webhook

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

### 3. Basic Configuration

![](https://callgrid.com/api/media/file/IPTemplate.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/IPconfig.png)

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

- InboundNumber maps to the phone number parameter for validation

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

- Phone number for validation and analysis
- Your API key for authentication
- Request for comprehensive fraud and reputation scoring

**Filtering**

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

- Add filters using any system tag (InboundState, BuyerName, CampaignName, etc.)
- Use **Equals** conditions to control when validation 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/IPvalue.png)

1. Select response properties like fraud_score, valid, carrier, line_type, etc.
2. Map them to custom tags for advanced routing and lead qualification
3. Use extracted data to automatically filter high-risk or invalid numbers
4. Route calls based on phone validation results and reputation scores

**Testing**

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

- Fill in test values for InboundNumber (use a real phone number format)
- Click **Run Webhook** to verify the integration
- Review the response data to see validation results and available properties

## Best Practices

- Monitor your API usage and credit consumption
- Set up value extraction to capture key validation metrics
- Use fraud scores and reputation data for call routing decisions
- Test with various number formats to ensure proper validation
- Configure filtering to avoid unnecessary API calls for internal numbers

## Troubleshooting

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

The integration enables real-time phone number validation and fraud detection, helping you automatically identify and route calls based on phone number quality, carrier information, and risk scoring to improve lead quality and prevent fraudulent activity.