Introduction

Mailfully is a transactional email API. You send email with one HTTP request or the Node SDK, and Mailfully delivers it and records every delivery event. It also receives email at your own domains or a hosted address. The API lives at https://api.mailfully.com, is versioned under /v1, and speaks JSON.

How it works

Sending is asynchronous. POST /v1/emails returns 202 Accepted with a message id. Delivery events arrive later: poll GET /v1/emails/{id}, or have them pushed to you through webhooks. An mf_test_ key lets you try all of this before you set up a domain.

There is no SMTP endpoint.

How sending works covers the full lifecycle, from queued to delivered, bounced or complained.

Get started

Quickstart

Send your first email in test mode, then verify a domain to go live.

API reference

Every endpoint, request field, and error type.

Webhooks

Receive delivery, bounce, and engagement events on your own endpoint.

Receiving email

Receive mail at your domain and read it over the API.

Node SDK

Typed client for Node 24+ with a { data, error } result on every call.

CLI

Send mail, verify domains, and read analytics from your terminal.