API de envío

Base y autenticación

Cada clave empieza por ms_…. La creas en la ficha del dominio, en Conexión.

Base

https://api.mailshogun.com

Cabecera

Authorization: Bearer ms_…

La clave necesita el permiso send y debe permitir tu IP, país y dominio de envío. También se usa para autenticar MCP, sujeto a sus permisos.

La clave se muestra una sola vez al crearla. Si la pierdes, revócala y crea otra.

Abrir Dominios

Ejemplos

Define MAILSHOGUN_API_KEY en el entorno del servidor. Sustituye from y to por un remitente verificado y un buzón que controles. curl usa sintaxis de shell POSIX; JavaScript usa Node.js con fetch en un archivo .mjs y PHP requiere la extensión cURL. Estos ejemplos sí envían al ejecutarlos.

curl

⧉curl -X POST https://api.mailshogun.com/v1/send \
  -H "Authorization: Bearer $MAILSHOGUN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "hola@tudominio.com",
    "to": ["destino@ejemplo.com"],
    "subject": "Hola",
    "html": "<p>Hola desde MailShogun</p>",
    "text": "Hola desde 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: 'hola@tudominio.com',
    to: ['destino@ejemplo.com'],
    subject: 'Hola',
    html: '<p>Hola desde MailShogun</p>',
    text: 'Hola desde 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' => 'hola@tudominio.com',
  'to' => ['destino@ejemplo.com'],
  'subject' => 'Hola',
  'html' => '<p>Hola desde MailShogun</p>',
  'text' => 'Hola desde 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

Las mismas claves API (Bearer ms_…). Las herramientas son list_domains y send_email.

Endpoint

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

Cabecera

Authorization: Bearer ms_…

Herramientas

list_domains, send_email