Laravel Email Verification — Emailable Driver

An Emailable deliverability driver for misaf/laravel-email-verification.

Features

• Registers the emailable verifier driver with the core manager
• Uses Emailable's verification API (GET /v1/verify)
• 6-second HTTP timeout, so a slow verification comes back as a clean result instead of hanging the request
• Retries only connection failures and 5xx responses — a 4xx, including a 429 rate limit, is never retried, so paid API quota is not burned on an answer that cannot change
• Explicit mapping for every Emailable verification state
• Safe unverifiable results for provider failures, malformed payloads, timeouts, and unexpected responses

Requirements

• PHP 8.4+
• Laravel 13
• misaf/laravel-email-verification

Installation

composer require misaf/laravel-email-verification-emailable

The service provider auto-registers and adds an emailable driver to the email verifier manager. Point the core package at it:

EMAIL_VERIFIER_DRIVER=emailable
EMAILABLE_HOST=https://api.emailable.com/v1/verify
EMAILABLE_API_KEY=your-key

Publish the config to override credentials:

php artisan vendor:publish --tag=laravel-email-verification-emailable-config

An install command is also available, which publishes the config and walks you through setup:

php artisan laravel-email-verification-emailable:install

Configuration

config/laravel-email-verification-emailable.php:

• host — the Emailable verification endpoint, normally https://api.emailable.com/v1/verify
• api_key — the private Emailable API key

The credentials remain separate from the provider-neutral core configuration.

Verification Outcomes

Malformed payloads, unsuccessful HTTP responses, timeouts, and exceptions also produce Unverifiable. They are never treated as deliverable.

Usage

Once EMAIL_VERIFIER_DRIVER points at emailable, the core EmailValidation rule uses this driver with no further changes. To use it for a single rule regardless of the configured default:

use Misaf\LaravelEmailVerification\Rules\EmailValidation;

$request->validate([
    'email' => ['bail', 'email:rfc,strict', new EmailValidation('emailable')],
]);

Verifying an address directly

use Misaf\LaravelEmailVerification\Enums\EmailVerificationStatus;
use Misaf\LaravelEmailVerification\Facades\EmailVerifier;

$status = EmailVerifier::driver('emailable')->verify('user@example.com');

if ($status === EmailVerificationStatus::Deliverable) {
    // The provider positively classified the address as deliverable.
}

Contributing

This repository is a read-only split of the misaf/laravel-email-verification monorepo, published for installation via Composer. Its contents are generated, so commits made here are overwritten by the next split.

Open issues and pull requests against the monorepo, where this driver lives at src/Drivers/laravel-email-verification-emailable and its tests run alongside the core package.

License

MIT. See LICENSE.