MailForge MailForge

Integration Guide

Everything you need to wire MailForge into your product.

Authentication

Authentication depends on the marketplace.
Most integrations use a Bearer token in the Authorization header, while some (e.g., RapidAPI) may require X-RapidAPI-Key. 

Header
Authorization: Bearer <YOUR_API_KEY>

Endpoints

  • POST /v1/validate — single email
  • POST /v1/bulk — batch
  • GET /health — status

See full API Docs.

Use "deep": true for extended SMTP-level validation when accuracy matters (e.g. sign-ups, fraud prevention, or bulk cleanup). Set to false for faster syntax + MX-only checks.

cURL examples

Single validation


          
        

        

          
Bulk validation

          

          
        

        

          
PowerShell (Windows)

          

          
        

      

    

  


  
  

    

      

        
Node / Express (middleware)

        

        
      

      

        
Python / FastAPI (dependency)

        

        
      

      

        
PHP / Guzzle

        

        
      

      

        
Ruby / Faraday

        

        
      

      

        
Go / net/http

        

        
      

      

        
Error handling (generic)