Forward Email API

This page explains the Forward Email API integration in GoAdmio. It connects GoAdmio to ForwardEmail.net — a low-cost transactional email and SMTP relay service — so you can activate a per-domain SMTP relay with automatic SPF and DKIM configuration.

Location: Admin Panel → Email → Forward Email API

Overview

ForwardEmail.net is a privacy-focused, low-cost email forwarding and SMTP relay service. GoAdmio integrates with its API so you can provision the relay per domain with a single command — no manual SMTP credential copying, no hand-editing DNS records.

When you activate a domain with ForwardEmail:

A custom SMTP relay is configured automatically for that domain's account
SPF and DKIM records are added to Cloudflare automatically
Outgoing mail from that domain routes through ForwardEmail's trusted infrastructure
Deliverability improves because ForwardEmail manages sender reputation, PTR, and authentication

This is an opt-in, per-domain setup — unlike Global SMTP Relay (which affects the whole server) or Brevo API (which is Roundcube-only). You choose exactly which domains route through ForwardEmail.

> Important: Forward Email API requires the Cloudflare API to be configured in GoAdmio first. Without Cloudflare API access, GoAdmio cannot add the SPF and DKIM records, and the domain will not authenticate at ForwardEmail.

How It Compares to Other Relay Options

| Feature | Scope | DNS auto-config | Requires Cloudflare API |
|---|---|---|---|
| Forward Email API (this page) | Per domain, opt-in | ✅ Yes — SPF + DKIM | ✅ Yes |
| Custom SMTP Relay | Per account | ❌ No | ❌ No |
| Global SMTP Relay | Server-wide | ❌ No | ❌ No |
| Brevo API | Roundcube only | ❌ No | ❌ No |
| Roundcube Global SMTP | Roundcube only | ❌ No | ❌ No |

> Tip: Forward Email API is the lowest-effort option per domain — one command sets up the relay and the DNS. Choose it when you want per-domain relays without manual DNS work.

Prerequisites

Before using Forward Email API:

A ForwardEmail.net account — https://forwardemail.net
A ForwardEmail API key — generated in the ForwardEmail dashboard
A paid ForwardEmail plan (or free tier if sufficient for your volume) that includes SMTP relay
The Cloudflare API configured in GoAdmio — required for SPF and DKIM auto-configuration. See Cloudflare API.
The domain managed in Cloudflare — the domain's DNS zone must be on Cloudflare, and its nameservers must point to Cloudflare
Root access to the GoAdmio Admin Panel
The domain is not already using a custom SMTP — if a domain has a custom SMTP set via Custom SMTP Relay, remove it first, or the ForwardEmail setup will not apply

> Warning: Cloudflare API is a hard requirement. If it is not configured, /go/forwardemail will fail to add the SPF and DKIM records, and the domain will not pass ForwardEmail's authentication checks. Mail may still send, but deliverability and domain verification will fail.

How to Configure Forward Email API

Step 1 — Get a ForwardEmail API key

Log in to ForwardEmail.net.
Navigate to Settings → API Keys (or the equivalent in your account).
Generate a new API key.
Copy the key — store it securely.

Step 2 — Add the API key in GoAdmio

Log in to the GoAdmio Admin Panel.
Navigate to Email → Forward Email API.
Paste the ForwardEmail API key.
Click Save.

The integration is now authenticated.

Step 3 — Verify Cloudflare API is configured

Forward Email API relies on Cloudflare to add SPF and DKIM records. Confirm Cloudflare is set up:

Navigate to Domain API → Cloudflare API — see Cloudflare API.
Confirm the Cloudflare credentials are saved and working.
Test by running a Cloudflare API check on any domain.

> Note: If Cloudflare API is not configured, stop here and configure it first. Forward Email activation will not complete without DNS auto-configuration.

Step 4 — Activate a domain

Once the API keys are in place, activate ForwardEmail for a domain from the command line:

```bash
/go/forwardemail domain.com