API Reference

Gomailify provides HTTP endpoints for sending emails and validating recipients.

Authentication

All API requests require authentication via the X-API-Key header:

Send Email

Send an RFC 2822 formatted email message.

POST https://beta.gomailify.com/submit/inbound
Content-Type: message/rfc822
X-API-Key: YOUR_API_KEY
X-Mail-From: sender@example.com
X-Mail-To: recipient@yourdomain.com
X-Trace-ID: unique-message-id

From: "Sender Name" <sender@example.com>
To: recipient@yourdomain.com
Subject: Test Email
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8

This is the email body.

Required Headers

• X-API-Key - Your API key
• X-Mail-From - Envelope sender address
• X-Mail-To - Envelope recipient address
• X-Trace-ID - Unique identifier for tracking

Response Codes

• 200 OK - Email queued successfully
• 400 Bad Request - Invalid email format or missing headers
• 401 Unauthorized - Invalid API key
• 404 Not Found - Recipient not found
• 429 Too Many Requests - Rate limit exceeded

Validate Recipient

Check if a recipient address exists and is active.

GET https://beta.gomailify.com/validate-recipient/recipient@yourdomain.com?sender=sender@example.com
Authorization: Bearer YOUR_BEARER_TOKEN

Query Parameters

• sender - Sender email address (for denylist checking)

Response Codes

• 200 OK - Recipient is valid and active
• 404 Not Found - Recipient not found or blocked