Custom Connector
MailboxLayer Connector
Global
The MailboxLayer Connector enables real-time email verification through the MailboxLayer API. It performs syntax validation, MX record lookups, SMTP verification, and detects disposable, free, or role-based email providers — serving as a proxy that standardizes API calls for easy integration within GCP or internal systems.
Overview
Integration Overview
This document provides a detailed guide for each integration endpoint, configuration, and workflow supported by the MailboxLayer Connector.
- verifySingleEmail. Verifies a single email address for validity and existence.
- verifyBulkEmails. Validates multiple email addresses in a single request.
Documentation
Detailed Integration Documentation
Single Email Verification
| Action | verifySingleEmail |
|---|---|
| Endpoint | GET /check |
| Purpose | Verifies a single email address for correctness and deliverability — syntax validity, MX record availability, SMTP response, and whether the address is disposable, role-based, or free. |
| Configuration | Configure the base URL via the connector’s base-URL environment variable. |
| Parameters | Required: access_key — your API key; email — address to verify (e.g. user@example.com). Optional: smtp (boolean) — perform SMTP validation; format (e.g. json); callback — JSONP callback name. |
| Output | Successful: JSON with email, format_valid, mx_found, smtp_check, catch_all, role, disposable, free, and a score (e.g. 0.88). Failure: error details. |
| Workflow example | Execute verifySingleEmail with email=user@example.com and your access_key, then display the verification score and deliverability status. |
Bulk Email Verification
| Action | verifyBulkEmails |
|---|---|
| Endpoint | GET /bulk_check |
| Purpose | Verifies multiple email addresses in a single request (up to 25 on Professional Plus, or 100 on Enterprise Plus), performing the same checks as single verification but returning batch results. |
| Configuration | Configure the base URL via the connector’s base-URL environment variable. |
| Parameters | Required: access_key — your API key; emails — comma-separated addresses (e.g. user1@example.com,user2@example.com). Optional: smtp (boolean); format (e.g. json); callback. |
| Output | Successful: JSON array of per-address results (format_valid, mx_found, smtp_check, free, score). Failure: error details. |
| Workflow example | Execute verifyBulkEmails with multiple addresses, then process the batch to display validity and score per address. |
Example Workflow: Bulk Validation & Quality Scoring
| Single email check | Use /check to validate individual inputs in a signup form and show user-friendly messages for invalid emails. |
|---|---|
| Bulk verification | For mailing lists or CRM imports, send /bulk_check with up to 100 addresses and filter out disposable or undeliverable ones via disposable, smtp_check, and score. |
| GCP integration | Deploy the service in Cloud Run or App Engine and connect to Apigee or Cloud Workflows for automation. |
Support
For technical support, contact custom-connectors-support@isolutions.sa.