MailPace

MailPace

@opencoredev/email-sdk/mailpace

OfficialNot API testedRequest tested

MailPace is a narrow send API adapter for simple transactional email. Use it when your messages only need address fields, reply-to, text, or HTML.

Before live sends

Create a MailPace server token and verify the sender or domain in MailPace. Because this adapter intentionally rejects headers, metadata, tags, and attachments, check your production message shape before using it as a fallback.

Configure

import { createEmailClient } from "@opencoredev/email-sdk";
import { mailpace } from "@opencoredev/email-sdk/mailpace";

const email = createEmailClient({
  adapters: [mailpace({ apiKey: process.env.MAILPACE_API_KEY! })],
});

Send

const result = await email.send({
  from: "Acme <hello@acme.com>",
  to: "user@example.com",
  cc: "billing@example.com",
  replyTo: "support@example.com",
  subject: "Plain transactional update",
  text: "Your account has been updated.",
});

console.log(result.provider, result.id);

MailPace is a narrow adapter for address fields plus text or HTML body content. It rejects headers, metadata, tags, and attachments before the API call.

Send HTML

await email.send({
  from: "Acme <hello@acme.com>",
  to: "user@example.com",
  subject: "Welcome",
  html: "<p>Your workspace is ready.</p>",
});

Options

Option	Type	Required	Notes
`apiKey`	`string`	Yes	MailPace server token.
`baseUrl`	`string`	No	Defaults to `https://app.mailpace.com/api/v1`.
`fetch`	`typeof fetch`	No	Useful for tests or custom runtimes.

MailPace supports CC, BCC, and reply-to. Unsupported fields throw before the API call.

Response

The adapter maps MailPace id or message_id to the normalized id field.

CLI smoke test

MAILPACE_API_KEY="..." npx email-sdk send \
  --adapter mailpace \
  --from "Acme <hello@acme.com>" \
  --to user@example.com \
  --subject "MailPace test" \
  --text "It works"