# Setting Up Blacklist Alliance Caller ID Lookup Webhook

> The Blacklist Alliance integration provides real-time caller ID verification to help your business stay compliant with TCPA regulations. 

Source: https://callgrid.com/knowledge-base/setting-up-blacklist-alliance-caller-id-lookup-webhook
Last updated: 2025-09-24
Topics: Integrations, Caller ID Lookup

The Blacklist Alliance integration checks incoming caller IDs against litigation databases to help maintain TCPA compliance and reduce legal risk.

## Setup Process

### 1. Create New Webhook

1. Navigate to **Integrations** → **Webhooks**
2. Click **+ New Webhook**
3. Select **Caller ID Lookup** template type
4. Choose **Blacklist Alliance** from the dropdown

### 2. Basic Configuration

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

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

### 3. Advanced Options (Optional)

After saving, you can configure additional settings:

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

**Filtering**

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

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

**Value Extraction**

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

- Run a webhook test first to see available response data
- Map response properties to custom tags for routing rules

**Testing**

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

- Fill in test values for detected variables
- Click **Run Webhook** to verify the integration works
- Check that the response contains the expected caller verification data

## Best Practices

- Test your configuration before going live
- Use filters to apply checks only when needed
- Monitor webhook performance and adjust timeout if necessary
- Keep your API credentials secure and up to date

## Troubleshooting

- Verify your API key is active and has the correct permissions
- Check that filter values match your system's actual tag values
- Use the testing tool to diagnose connection issues
- Contact support if you encounter persistent problems

The integration helps protect your calling campaigns by identifying high-risk callers in real-time, supporting your compliance efforts while maintaining operational efficiency.