SmartyStreets

Overview

The SmartyStreets integration for LeadExec provides real-time address validation and standardization for U.S. leads. By leveraging the SmartyStreets Cloud API, LeadExec ensures that all submitted addresses are accurate, deliverable, and formatted according to USPS standards. This integration helps reduce undeliverable mail, improves lead quality, and supports compliance with client requirements.

Key Features

• Real-Time Address Validation: Instantly checks and validates U.S. addresses as leads are ingested.
• USPS Standardization: Formats addresses to USPS standards, correcting misspellings, abbreviations, and incomplete data.
• Deliverability Check: Flags undeliverable or non-existent addresses, allowing for automated rejection or flagging based on campaign rules.
• Campaign-Level Control: Enable or disable SmartyStreets validation per campaign, with flexible mapping of address fields.
• Integration Criteria Builder: Exposes validation results (valid, deliverable, standardized address) for use in campaign logic, supporting granular acceptance or flagging.
• Comprehensive Logging: Stores API responses (with sensitive data masked) for audit and troubleshooting.
• Error Handling: Handles API errors gracefully, with retry logic for transient issues and clear logging for all error types.

How It Works

1. Setup

   • Enter your SmartyStreets API credentials in LeadExec’s global integration settings.
   • Enable SmartyStreets validation for specific campaigns and map the address fields.

2. Execution Flow

   • When a lead is submitted, LeadExec calls the SmartyStreets API:

     POST https://us-street.api.smarty.com/street-address?auth-id={AUTH_ID}&auth-token={AUTH_TOKEN}

   • The API response includes:
     • delivery_line_1, delivery_line_2
     • last_line (city, state, ZIP)
     • components (street, city, state, ZIP, etc.)
     • analysis (DPV match, active status, etc.)
   • Default decision logic:
     • If address is undeliverable or invalid: Reject the lead.
     • If address is valid but not standardized: Flag the lead.
     • Otherwise: Accept the lead.

3. Error Handling

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

Benefits

• Improved Lead Quality: Ensures only valid, deliverable addresses are accepted.
• Reduced Return Mail: Minimizes undeliverable mail and wasted outreach.
• USPS Compliance: Guarantees addresses meet USPS formatting and deliverability standards.
• Operational Efficiency: Automates address correction and validation, reducing manual review.