README

The official PHP client for the MailOdds email deliverability platform. Validate emails, send transactional messages, and monitor deliverability from any PHP application, with first-class support for Laravel and WordPress.

Installation

composer require mailodds/mailodds-php

Requires PHP 8.1 or later.

Quick Start

<?php
require_once __DIR__ . '/vendor/autoload.php';

$config = MailOdds\Configuration::getDefaultConfiguration()
    ->setAccessToken(getenv('MAILODDS_API_KEY'));

$api = new MailOdds\Api\EmailValidationApi(new GuzzleHttp\Client(), $config);

$request = new MailOdds\Model\ValidateRequest(['email' => 'user@example.com']);
$result = $api->validateEmail($request);

echo "Status: " . $result->getResult()->getStatus() . "\n";
echo "Action: " . $result->getResult()->getAction() . "\n";

MailOdds Platform

MailOdds provides a full-stack email deliverability platform. Explore the capabilities that this SDK connects you to:

• Email Validation API - Real-time email verification with 25+ checks
• Email Sending API - Transactional email delivery with DKIM dual signing
• Transactional Email - Reliable SMTP delivery for application email
• Email Webhooks - Real-time delivery, bounce, and engagement notifications
• Ecommerce Email - Email tools built for online stores
• DMARC Monitoring - Aggregate report parsing and policy recommendations
• Sender Reputation - Domain and IP reputation scoring
• Email Suppression List - Centralized suppression management
• Email Validation Policies - Rule-based validation with preset templates
• Ecommerce Email Integration - WooCommerce, Shopify, and PrestaShop connectors
• Free Email Validator - Try single-email validation on the homepage

Features

• PSR-18 compatible - Works with any HTTP client that implements the PSR-18 standard, with Guzzle included as the default transport
• Fully typed models - Every API request and response is represented by a strongly-typed PHP class, providing IDE autocompletion and static analysis support
• Laravel and WordPress ready - Drop into Laravel service providers or use alongside the MailOdds WordPress plugin with no additional configuration
• Bulk validation support - Submit lists of up to 500,000 emails per job via JSON, file upload, or S3 presigned URL, with webhook callbacks on completion
• Sending and deliverability - Send transactional email, monitor DMARC reports, track blacklist status, and score sender reputation from one SDK
• Comprehensive error handling - Structured error responses with machine-readable codes and request IDs for debugging

Why MailOdds

MailOdds is a complete email deliverability platform built for developers. Every email validated or sent through MailOdds passes through 25+ real-time checks including syntax verification, DNS and MX validation, SMTP mailbox probing, disposable domain detection, and role account identification.

The platform maintains sub-200ms median response times for single validations, 99.9% API uptime, and processes bulk lists of up to 500,000 emails per job. MailOdds supports 11 language SDKs, an MCP server for AI agent integration, a CLI for local development, and a WordPress plugin for no-code deployments.

All email sending uses DKIM dual signing with automated key rotation, and the deliverability monitoring stack covers DMARC aggregate reports, blacklist surveillance across 80+ DNSBLs, and real-time sender health scoring.

API Reference

Full documentation is available at https://mailodds.com/docs.

All URIs are relative to https://api.mailodds.com/v1.

Other SDKs

Resources

• API Documentation
• Dashboard
• Privacy Policy
• Blog
• Contact Support

License

MIT