API Reference

Authorization: mu_live_<40-hex-characters>

{
  "errors": [
    {
      "message": "Domain 'example.com' is not registered to your account."
    }
  ]
}

X-MSYS-API: {"campaign_id": "summer2024", "metadata": {"user_id": "123"}, "options": {"transactional": true}}

$mail = new PHPMailer\PHPMailer\PHPMailer(true);
$mail->isSMTP();
$mail->Host       = 'smtp.proiton.com';
$mail->Port       = 2525;
$mail->SMTPSecure = PHPMailer\PHPMailer\PHPMailer::ENCRYPTION_STARTTLS;
$mail->SMTPAuth   = true;
$mail->Username   = 'SMTP_Injection';
$mail->Password   = 'mu_live_YOUR_API_KEY';

$mail->setFrom('[email protected]', 'My App');
$mail->addAddress('[email protected]', 'John');
$mail->Subject = 'Welcome!';
$mail->Body    = '<h1>Hello!</h1>';
$mail->AltBody = 'Hello!';

$mail->send();

import smtplib
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart

msg = MIMEMultipart('alternative')
msg['From'] = '[email protected]'
msg['To'] = '[email protected]'
msg['Subject'] = 'Welcome!'
msg.attach(MIMEText('Hello!', 'plain'))
msg.attach(MIMEText('<h1>Hello!</h1>', 'html'))

with smtplib.SMTP('smtp.proiton.com', 2525) as server:
    server.starttls()
    server.login('SMTP_Injection', 'mu_live_YOUR_API_KEY')
    server.send_message(msg)

const nodemailer = require('nodemailer');

const transporter = nodemailer.createTransport({
    host: 'smtp.proiton.com',
    port: 2525,
    secure: false,
    auth: { user: 'SMTP_Injection', pass: 'mu_live_YOUR_API_KEY' },
});

await transporter.sendMail({
    from: '[email protected]',
    to: '[email protected]',
    subject: 'Welcome!',
    text: 'Hello!',
    html: '<h1>Hello!</h1>',
});

{
  "recipients": [
    {
      "address": {
        "email": "[email protected]",
        "name": "Recipient Name"
      },
      "substitution_data": {
        "custom_key": "custom_value"
      },
      "metadata": {
        "user_id": "123"
      }
    }
  ],
  "content": {
    "from": {
      "email": "[email protected]",
      "name": "Sender Name"
    },
    "subject": "Hello {{address.name or 'there'}}",
    "html": "<p>Welcome {{first_name or 'Guest'}}!</p>",
    "text": "Welcome {{first_name or 'Guest'}}!",
    "reply_to": "[email protected]",
    "attachments": [
      {
        "name": "document.pdf",
        "type": "application/pdf",
        "data": "<base64-encoded-content>"
      }
    ],
    "inline_images": [
      {
        "name": "logo",
        "type": "image/png",
        "data": "<base64-encoded-content>"
      }
    ]
  },
  "substitution_data": {
    "global_key": "global_value"
  },
  "metadata": {
    "campaign_id": "summer2024"
  },
  "description": "Summer campaign batch 1",
  "options": {
    "transactional": false
  }
}

{
  "results": {
    "total_rejected_recipients": 0,
    "total_accepted_recipients": 1,
    "id": "t-abc12345"
  }
}

{
  "results": {
    "transmission_id": "t-abc12345",
    "state": "completed",
    "description": "Summer campaign batch 1",
    "rcpt_to": 100,
    "total_accepted_recipients": 100,
    "total_rejected_recipients": 0,
    "created_at": "2024-06-15T10:30:00+00:00"
  }
}

{
  "address": {
    "name": "Recipient Name",
    "email": "[email protected]"
  }
}

{
  "results": [
    {
      "type": "delivery",
      "message_id": "550e8400-e29b-41d4-a716-446655440000",
      "recipient": "[email protected]",
      "timestamp": "2024-06-15T10:35:00+00:00",
      "transmission_id": "t-abc12345",
      "subject": "Summer Campaign",
      "detail": null
    }
  ],
  "total_count": 1,
  "links": {
    "next": null,
    "previous": null
  }
}

{
  "name": "My Webhook",
  "target": "https://api.example.com/webhooks/proiton",
  "events": ["injection", "delivery", "bounce", "open", "click"],
  "auth_type": "token",
  "auth_token": "my-secret-token",
  "sending_domain": "yourdomain.com"
}

{
  "results": {
    "id": "1",
    "name": "My Webhook",
    "target": "https://api.example.com/webhooks/proiton",
    "sending_domain": "yourdomain.com",
    "auth_type": "token",
    "events": ["injection", "delivery", "bounce", "open", "click"],
    "active": true,
    "links": []
  }
}

{
  "name": "Updated Name",
  "target": "https://api.example.com/webhooks/new-url",
  "events": ["delivery", "bounce", "open"],
  "active": false
}

[
  {
    "msys": {
      "message_event": {
        "type": "delivery",
        "event_id": "123456",
        "timestamp": 1718440500,
        "message_id": "550e8400-e29b-41d4-a716-446655440000",
        "rcpt_to": "[email protected]",
        "msg_from": "[email protected]",
        "friendly_from": "Sender Name <[email protected]>",
        "subject": "Summer Campaign",
        "customer_id": "5",
        "transmission_id": "t-abc12345",
        "rcpt_meta": {"user_id": "123"},
        "rcpt_tags": [],
        "sending_domain": "domain.com",
        "campaign_id": "summer2024",
        "raw_reason": "",
        "reason": "",
        "bounce_class": "",
        "classification_name": "",
        "classification_category": ""
      }
    }
  }
]

[
  {
    "msys": {
      "track_event": {
        "type": "click",
        "event_id": "789012",
        "timestamp": 1718440600,
        "message_id": "550e8400-e29b-41d4-a716-446655440000",
        "rcpt_to": "[email protected]",
        "customer_id": "5",
        "transmission_id": "t-abc12345",
        "rcpt_meta": {},
        "rcpt_tags": [],
        "campaign_id": "summer2024",
        "ip_address": "192.0.2.1",
        "user_agent": "Mozilla/5.0...",
        "geo_ip": {"country": "US"},
        "target_link_url": "https://example.com/promo"
      }
    }
  }
]

{
  "results": [
    {
      "recipient": "[email protected]",
      "type": ["non_transactional", "transactional"],
      "source": "hard_bounce",
      "description": "550 5.1.1 User unknown",
      "created": "2026-02-13T12:01:05+00:00",
      "updated": "2026-02-13T12:01:05+00:00"
    }
  ]
}

{
  "results": [
    {
      "recipient": "[email protected]",
      "type": ["non_transactional"],
      "source": "manual",
      "description": "Opted out",
      "created": "2026-02-10T08:00:00+00:00",
      "updated": "2026-02-10T08:00:00+00:00"
    }
  ]
}

{
  "recipients": [
    {
      "recipient": "[email protected]",
      "type": "non_transactional",
      "description": "Opted out of marketing"
    },
    {
      "recipient": "[email protected]",
      "type": "transactional",
      "description": "Do not contact"
    }
  ]
}

{
  "results": {
    "message": "2 suppression(s) updated."
  }
}

{
  "domain": "yourdomain.com",
  "tracking_domain": "track.yourdomain.com"
}

{
  "results": {
    "message": "Successfully Created domain.",
    "domain": "yourdomain.com",
    "dkim": {
      "public": "MIGfMA0GCSqGSIb3DQEB...",
      "selector": "default",
      "signing_domain": "yourdomain.com",
      "headers": "from:to:subject:date"
    }
  }
}

{
  "results": [
    {
      "domain": "yourdomain.com",
      "tracking_domain": "track.yourdomain.com",
      "status": {
        "ownership_verified": true,
        "spf_status": "valid",
        "dkim_status": "valid",
        "cname_status": "unverified",
        "compliance_status": "valid",
        "verification_token": "abc123..."
      },
      "dkim": {
        "public": "MIGfMA0GCSqGSIb3DQEB...",
        "selector": "default",
        "signing_domain": "yourdomain.com",
        "headers": "from:to:subject:date"
      },
      "is_default_bounce_domain": false,
      "shared_with_subaccounts": false
    }
  ]
}

{
  "results": {
    "domain": "yourdomain.com",
    "tracking_domain": "track.yourdomain.com",
    "status": {
      "ownership_verified": true,
      "spf_status": "valid",
      "dkim_status": "valid",
      "cname_status": "valid",
      "compliance_status": "valid",
      "verification_token": "abc123..."
    },
    "dkim": {
      "public": "MIGfMA0GCSqGSIb3DQEB...",
      "selector": "default",
      "signing_domain": "yourdomain.com",
      "headers": "from:to:subject:date"
    },
    "is_default_bounce_domain": false,
    "shared_with_subaccounts": false
  }
}

{
  "tracking_domain": "track.yourdomain.com",
  "open_tracking": true,
  "click_tracking": true
}

{
  "results": {
    "message": "Successfully Updated Domain.",
    "domain": "yourdomain.com"
  }
}

{
  "dkim_verify": true,
  "spf_verify": true
}

{
  "results": {
    "ownership_verified": true,
    "spf_status": "valid",
    "dkim_status": "valid",
    "cname_status": "unverified",
    "compliance_status": "valid",
    "dns": {
      "dkim_record": "v=DKIM1; k=rsa; p=MIGfMA0GCSqGSIb3DQEB...",
      "dkim_error": "",
      "spf_record": "v=spf1 include:proitonmail.com ~all",
      "spf_error": ""
    }
  }
}

curl -X POST https://proiton.com/api/v1/transmissions \
  -H "Authorization: mu_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "recipients": [
      {"address": {"email": "[email protected]", "name": "John"}}
    ],
    "content": {
      "from": {"email": "[email protected]", "name": "My App"},
      "subject": "Welcome {{address.name}}!",
      "html": "<h1>Hello {{address.name}}</h1><p>Welcome aboard!</p>",
      "text": "Hello {{address.name}}, welcome aboard!"
    }
  }'

$client = new \GuzzleHttp\Client();

$response = $client->post('https://proiton.com/api/v1/transmissions', [
    'headers' => [
        'Authorization' => 'mu_live_YOUR_API_KEY',
        'Content-Type'  => 'application/json',
    ],
    'json' => [
        'recipients' => [
            ['address' => ['email' => '[email protected]', 'name' => 'John']],
        ],
        'content' => [
            'from'    => ['email' => '[email protected]', 'name' => 'My App'],
            'subject' => 'Welcome {{address.name}}!',
            'html'    => '<h1>Hello {{address.name}}</h1><p>Welcome!</p>',
        ],
    ],
]);

$result = json_decode($response->getBody(), true);
echo $result['results']['id']; // t-abc12345

const response = await fetch('https://proiton.com/api/v1/transmissions', {
  method: 'POST',
  headers: {
    'Authorization': 'mu_live_YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    recipients: [
      { address: { email: '[email protected]', name: 'John' } },
    ],
    content: {
      from: { email: '[email protected]', name: 'My App' },
      subject: 'Welcome {{address.name}}!',
      html: '<h1>Hello {{address.name}}</h1><p>Welcome!</p>',
    },
  }),
});

const { results } = await response.json();
console.log(results.id); // t-abc12345