Skip to content
MLAS API

Introduction

The Marketing Lead Automation Service (MLAS) is a comprehensive lead processing platform that enables partners to submit, track, and manage consumer leads for debt relief and financial services.

What is the Marketing Lead Automation Service?

The MLA Service provides:

  • Lead Submission - Submit leads via GraphQL API with comprehensive applicant data
  • Real-time Processing - Automated workflows for credit checks, deduplication, and qualification
  • Status Lookup - Query lead status by ID for reconciliation and troubleshooting
  • CRM Integration - Submit qualified leads to our CRM for enrollment
  • Bid Values - Receive bid amounts based on lead qualification

How It Works

The service uses one response pattern for all workflows:

  • createLead waits for workflow completion before returning.
  • Flow behavior differs by configured workflow steps and partner-specific internal CRM submission configuration.

Lead Processing Flow

1. Submit Lead

Partner submits lead data via the createLead mutation

2. Processing

Lead goes through automated qualification workflows

3. Receive Final Result

createLead returns the completed workflow result and bid value (if qualified)

4. CRM Submission Path

Depending on partner configuration: automatic submission for qualified leads or manual submitLead

Lead Processing Flow

┌─────────────────┐     ┌─────────────────┐     ┌───────────────────────────┐
│   createLead    │────▶│   Processing    │────▶│ createLead response       │
│   (Mutation)    │     │   Workflows     │     │ (final result + bidValue) │
└─────────────────┘     └─────────────────┘     └───────────────────────────┘
                                                  │
                      automatic submit configured │ manual submit configured
                                                  ▼
                                          ┌─────────────────┐
                                          │   submitLead    │
                                          │   (Mutation)    │
                                          └─────────────────┘

Processing Workflows

When a lead is submitted, it goes through several processing steps:

  1. Deduplication - Check for duplicate leads in the system
  2. TrustedForm Verification - Verify consent certificate (if provided)
  3. Credit Pull - Retrieve credit information for qualification
  4. Eligibility Scoring - Determine qualification based on credit data
  5. Bid Calculation - Calculate bid value for qualified leads

API Technology

The MLA Service uses GraphQL for its API:

  • Strongly Typed - All inputs and outputs are strictly typed
  • Introspection - Query the schema to discover available operations
  • Single Endpoint - All operations go through one endpoint
  • Flexible Queries - Request only the fields you need

Next Steps

  1. Set up Authentication to get your API credentials
  2. Review the Environments to understand available endpoints
  3. Follow the Quick Start to make your first API call
  4. Use Sandbox Test Archetypes to test every result code with deterministic outcomes