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
mf_live_e28a_••••••••••••••••Used: 2026-07-25 19:40
Staging sandbox-tester
Created 2026-07-15 14:02
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
REST JSON RESPONSESTATUS 200 OK
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.