Abstract API

Overview

The AbstractAPI integration for LeadExec provides real-time phone number validation and carrier lookup. This integration is designed to improve lead quality, reduce failed outreach attempts, and ensure compliance by automatically rejecting or flagging invalid or high-risk phone numbers as leads are ingested.

Key Features

• Real-Time Validation: Every phone number submitted to LeadExec is checked instantly using AbstractAPI’s Phone Validation endpoint.
• Carrier & Line-Type Detection: The API returns details such as validity, line type (mobile, landline, VoIP, premium, toll-free), carrier, country code, and location.
• Automated Lead Filtering: Based on the validation response, leads can be accepted, rejected, or flagged according to configurable rules.
• Campaign-Level Control: The integration can be enabled or disabled per campaign, with flexible mapping of the phone field and custom response handling.
• Integration Criteria Builder: Exposes validation results (valid, type, carrier) for use in campaign logic, allowing granular control over lead acceptance and flagging.
• Comprehensive Logging: Full API responses are stored (with API keys masked) for 30 days, and key fields are surfaced in the LeadExec UI for inspection.
• Error Handling & Retries: Implements robust retry logic for quota and rate-limit errors, with exponential backoff and clear logging for all error types.

How It Works

1. Setup

   • Enter your AbstractAPI key in LeadExec’s global integration settings.
   • Enable AbstractAPI validation for specific campaigns and map the phone field.

2. Execution Flow

   • When a lead is submitted, LeadExec calls the AbstractAPI endpoint:

     GET https://phonevalidation.abstractapi.com/v1/?api_key={API_KEY}&phone={phone_number}

   • The API response is parsed for key fields:
     • valid (boolean)
     • type (e.g., mobile, landline, VoIP, premium, toll_free)
     • carrier
     • country.code
     • location
   • Default decision logic:
     • If valid is false: Reject the lead.
     • If type is VoIP, Premium, or Toll_Free: Flag the lead.
     • Otherwise: Accept the lead.

3. Error Handling

   • 400/401: Log and skip retry.
   • 422/429: Retry with backoff (up to 2-3 times).
   • 5xx: Exponential backoff, then flag if still failing.

Benefits

• Improved Lead Quality: Invalid and risky numbers are filtered out before delivery.
• Reduced Compliance Risk: Flags VoIP and premium numbers to help manage TCPA and carrier compliance.
• Operational Efficiency: Reduces wasted outreach and carrier costs by ensuring only valid numbers are processed.