Sending API

Base and authentication

Every key starts with ms_…. You create it on the domain page, under Connection.

Base

https://api.mailshogun.com

Header

Authorization: Bearer ms_…

The key needs the send scope and must allow your IP, country and sending domain. It also authenticates MCP, subject to its permissions.

The key is shown only once when you create it. If you lose it, revoke the key and create another.

Open Domains

Examples

Set MAILSHOGUN_API_KEY in the server environment. Replace from and to with a verified sender and a mailbox you control. curl uses POSIX shell syntax; JavaScript uses Node.js with fetch in an .mjs file and PHP requires the cURL extension. Running these examples sends an email.

curl

⧉curl -X POST https://api.mailshogun.com/v1/send \
  -H "Authorization: Bearer $MAILSHOGUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "hello@yourdomain.com",
    "to": ["you@example.com"],
    "subject": "Hello",
    "html": "<p>Hello from MailShogun</p>",
    "text": "Hello from MailShogun"
  }'

Node.js (fetch)

⧉const apiKey = process.env.MAILSHOGUN_API_KEY;
if (!apiKey) throw new Error('Missing MAILSHOGUN_API_KEY');
const response = await fetch('https://api.mailshogun.com/v1/send', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ' + apiKey,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    from: 'hello@yourdomain.com',
    to: ['you@example.com'],
    subject: 'Hello',
    html: '<p>Hello from MailShogun</p>',
    text: 'Hello from MailShogun'
  })
});
const body = await response.json();
if (response.status !== 202) {
  throw new Error('HTTP ' + response.status + ': ' + JSON.stringify(body));
}
console.log(body);

PHP

⧉<?php
$apiKey = getenv('MAILSHOGUN_API_KEY');
if (!$apiKey) { throw new RuntimeException('Missing MAILSHOGUN_API_KEY'); }
$payload = [
  'from' => 'hello@yourdomain.com',
  'to' => ['you@example.com'],
  'subject' => 'Hello',
  'html' => '<p>Hello from MailShogun</p>',
  'text' => 'Hello from MailShogun',
];
$ch = curl_init('https://api.mailshogun.com/v1/send');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . $apiKey,
    'Content-Type: application/json',
  ],
  CURLOPT_POSTFIELDS => json_encode($payload),
  CURLOPT_RETURNTRANSFER => true,
]);
$body = curl_exec($ch);
if ($body === false) { throw new RuntimeException(curl_error($ch)); }
$code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
// 202 + {"status":"queued"} on success
if ($code !== 202) { throw new RuntimeException('HTTP ' . $code . ': ' . $body); }
echo $body;

MCP

The same API keys (Bearer ms_…). The tools are list_domains and send_email.

Endpoint

POST https://mcp.mailshogun.com/mcp

Header

Authorization: Bearer ms_…

Tools

list_domains, send_email