SYSTEM LIVE
Providers:Resend: Sandbox 🟢Postmark: Active 🟢
MailForge AgentMail™

Developer SDK & API Hub

Provision scoped authorization tokens, download client packages, and build embeddable agent run widgets for standard customer portals.

SDK v0.7.4 (Stable)

Create API Token

Secure Key Vault

Production assistant-sdk

Created 2026-04-18 10:25

active
mf_live_e28a_••••••••••••••••
Used: 2026-07-25 19:40

Staging sandbox-tester

Created 2026-07-15 14:02

active
mf_test_619d_••••••••••••••••
Used: 2026-07-25 20:15

Client Integration Templates

"use client";
import { MailForgeAgentClient } from "@mailforge/agent-sdk";

const client = new MailForgeAgentClient({
  apiKey: process.env.NEXT_PUBLIC_MAILFORGE_API_KEY || ""
});

export default function AgentChatWidget() {
  const handleTriggerRun = async () => {
    const run = await client.runs.create({
      agentId: "assistant-general",
      payload: {
        subject: "Contract Question",
        bodyText: "What is the custom enterprise tier price?"
      }
    });
    console.log("Agent Output:", run.output);
  };

  return (
    <button onClick={handleTriggerRun}>
      Run Agent Memory Query
    </button>
  );
}

Agent SDK Run Simulator

Test a live client-to-agent S2S execution query locally.

Edge execution logsLive Channel

Click 'Send Test Run' to trigger trace streams.

REST JSON RESPONSESTATUS 200 OK

Awaiting execution output payload...

HMAC-SHA256 Webhook Verification

When an agent generates actions or intercepts runs requiring approval, MailForge posts a signed JSON payload to your webhook endpoints. To prevent replays and verify signatures, extract the `x-mailforge-signature` header and validate using your webhook secret key.