Ontwikkelaars

Drie manieren om aan te sluiten. SMTP, JSON of een agent.

Sluit een bestaand platform aan op de relay, automatiseer alles via de REST API of laat een AI-agent het werk doen via MCP. De REST API gebruikt HTTP Basic-authenticatie; MCP gebruikt een apart Bearer-token met specifieke rechten.

SMTP-relay

Zonder code

Hostsend.smtp.software

Poort465 / SSL

Gebruikersnaamper verzenddomein

Wachtwoordop de domeinpagina

REST API

JSON

Basis-URLsmtp.software/api

AuthenticatieBasic · gebruiker “api”

WachtwoordAPI-wachtwoord van het account

Inhoudapplication/json

MCP voor AI-agents

Nieuw

Serversmtp.software/mcp

TransportStreamable HTTP

Authenticatieapart Bearer-token met specifieke rechten

ClientondersteuningBearer-authenticatie · JSON POST

# 1. Registreer het domein (201 nieuw · 200 al van jou)
curl --user "api:$SMTP_API_PASSWORD" \
--header 'Content-Type: application/json' \
--data '{"domain":"shop.example"}' \
https://smtp.software/api/domains
# 2. Welke records moeten nog worden gepubliceerd?
curl --user "api:$SMTP_API_PASSWORD" \
https://smtp.software/api/domains/shop.example \
| jq '.response.result.dns_records[] | select(.valid == false)'
# 3. Controleer direct in plaats van te wachten op de cyclus van 5 minuten
curl --request POST --user "api:$SMTP_API_PASSWORD" \
https://smtp.software/api/domains/shop.example/verify
// PHPMailer — gebruik dezelfde waarden in Magento, WooCommerce of een SMTP-plugin
$mail = new PHPMailer(true);
$mail->isSMTP();
$mail->Host       = 'send.smtp.software';
$mail->Port       = 465;
$mail->SMTPSecure = 'ssl';
$mail->SMTPAuth   = true;
$mail->Username   = getenv('SMTP_USER');   // van de domeinpagina
$mail->Password   = getenv('SMTP_PASS');
$mail->setFrom('orders@shop.example', 'Shop');
$mail->addAddress('emma@example.com', 'Emma');
$mail->Subject = 'Your order #10482 is confirmed';
$mail->msgHTML($html);
$mail->send();
# .env — mailers voor Laravel / Lumen / Symfony
MAIL_MAILER=smtp
MAIL_HOST=send.smtp.software
MAIL_PORT=465
MAIL_ENCRYPTION=ssl
MAIL_USERNAME=<smtp-username>
MAIL_PASSWORD=<smtp-password>
MAIL_FROM_ADDRESS=orders@shop.example
MAIL_FROM_NAME="Shop"
# Magento 2: Stores › Configuration › Advanced › System › Mail Sending Settings
# WooCommerce / WordPress: een SMTP-plugin — dezelfde host, poort en inloggegevens
# Shopware / PrestaShop / Lightspeed: mailinstellingen → SMTP, dezelfde waarden
// POST https://smtp.software/api/shop.example/message
{
"from": { "address": "orders@shop.example", "name": "Shop" },
"to":   [{ "address": "emma@example.com", "name": "Emma" }],
"cc":   [], "bcc": [],
"subject": "Your order #10482 is confirmed",
"text": "Thanks Emma, your order is on its way.",
"html": "<p>Thanks Emma, your order is on its way.</p>",
"template": "order-confirmation",
"attachments": [{ "filename": "Invoice.pdf", "filedisposition": "attachment", "data": "<base64>" }],
"tags": [{ "title": "order", "name": "10482", "link": "https://shop.example/orders/10482" }]
}
// GET https://smtp.software/api/shop.example/logs
{ "refid": "c4ca4238a0b923820dcc509a6f75849b", "recipient": "emma@example.com", "limit": 10 }
// Algemene clientconfiguratie — aangepaste Bearer-authenticatie + Streamable HTTP-antwoorden in JSON
{
"mcpServers": {
"smtp-software": {
"url": "https://smtp.software/mcp",
"headers": { "Authorization": "Bearer ${SMTP_MCP_TOKEN}" }
}
}
}
// Bewaar het token in de beveiligde opslag van je client; de syntaxis voor verwijzingen naar geheimen verschilt.
// Tools zijn alleen beschikbaar als de rechten van het token dit toestaan
account_get()                           → account:read
domains_list(limit, offset)               → domains:read
domain_register(domain)                  → domains:write
domain_get(domain)                       → domains:read
domain_verify(domain)                    → domains:write
message_send(domain, from, to, subject, text, idempotency_key) → messages:send · één e-mail in de wachtrij plaatsen
messages_list(domain, recipient, refid, limit) → messages:read
// Aanvullende analysetools met alleen-lezenrechten
statistics_summary · statistics_timeseries · statistics_domains → statistics:read
dmarc_summary · dmarc_timeseries · dmarc_domains · dmarc_sources → dmarc:read
// Transactional Studio: schakel de werkruimte in en verleen templaterechten
templates_list · template_get → templates:read
template_preview → templates:preview · alleen gepubliceerde templates
message_send_template → templates:use + messages:send
// Vraag daarna gewoon:
"Sluit mail.bloomstudio.example aan en vertel me welke DNS-records nog ontbreken."
// REST API-endpoints gebruiken dit antwoordformaat
{
"response": {
"status": true,
"message": "Domain status.",
"result": {
"domain": "shop.example",
"status": "pending",
"sending_ready": true,
"fully_verified": false,
"validation": { "spf": true, "dkim": true, "dmarc": false, "tracking": true, "mx_primary": false, "mx_secondary": false },
"dns_records": [
{ "purpose": "dmarc", "type": "TXT", "host": "_dmarc.shop.example", "value": "v=DMARC1; p=quarantine", "required": true, "valid": false }
],
"last_checked_at": "2026-10-22T09:45:00+00:00"
}
}
}

Transactionele API v2

Verzend een gepubliceerde template met de gegevens van je applicatie.

Schakel Transactional Studio in voor de werkruimte, publiceer een template en taalversie en roep vervolgens POST /api/v2/messages aan met een Bearer-token met specifieke rechten en een Idempotency-Key. Een preview verstuurt niets; HTTP 202 betekent dat het bericht in de wachtrij staat. Aflevergebeurtenissen melden de verdere voortgang.

De v2 API heeft eigen instellingen, merken, templates, berichten, ontvangerblokkades en optionele ondertekende webhooks. De bestaande SMTP- en legacy REST-contracten blijven beschikbaar.

Lees de referentie voor de transactionele API →

Endpoints

Domeinen aansluiten en berichten verzenden via REST.

GET

/connect

Controleer je inloggegevens.

GET

/domains

Alle domeinen van het account met de opgeslagen validatiestatus. Geen DNS-opzoeking.

POST

/domains

Registreer {"domain":"shop.example"}. Herhaalbaar: 201 bij een nieuw domein, 200 als het al bestaat. Geeft een actuele DNS-validatie terug.

GET

/domains/{domain}

Opgeslagen status en de exacte records om te publiceren, elk met required en valid.

POST

/domains/{domain}/verify

Synchrone DNS-controle; het resultaat wordt opgeslagen en teruggegeven. Gebruik dit nadat een klant DNS wijzigt.

POST

/{domain}/message

Verzenden: from, to, cc, bcc, subject, text, html, template, attachments, tags.

GET

/{domain}/logs

Afleverlogs, gefilterd op refid, recipient en limit.

DNS-records

Wat “verified” betekent.

SPFTXT @ → v=spf1 include:spf.smtp.software ~allrequired

DKIMCNAME ss._domainkey → dkim.smtp.softwarerequired

DMARCTXT _dmarc → v=DMARC1; p=…required

TrackingCNAME track → track.smtp.softwarerequired

MXMX @ → mxa.smtp.software / mxb.smtp.softwareoptioneel

status is verified zodra SPF, DKIM, DMARC en tracking allemaal geldig zijn. sending_ready vereist alleen SPF. Onvolledige domeinen worden elke 5 minuten opnieuw gecontroleerd, geverifieerde domeinen elke 24 uur.

Statuscodes

200

OK, of het domein is al van jou

201

Domein geregistreerd

400

Ongeldige JSON-inhoud

401

Onjuiste of ontbrekende inloggegevens

404

Domein hoort niet bij dit account

409

Domein hoort bij een ander account

422

Geen geldig publiek domein

500

Registratie of opslag mislukt

MCP voor AI-agents

Laat de agent de webshop aansluiten.

Onze MCP-server biedt tools met specifieke rechten voor domeinen, DNS, aflevermetadata en het in de wachtrij plaatsen van afzonderlijke e-mails. Gebruik een client met ondersteuning voor aangepaste Bearer-authenticatie en Streamable HTTP-antwoorden in JSON om een domein te registreren, ontbrekende DNS-records te bekijken, na publicatie opnieuw te controleren en afleverlogs te lezen.

Jij

Sluit mail.bloomstudio.example aan voor de nieuwe WooCommerce-klant en vertel me welke DNS-records nog nodig zijn.

→ domain_register · domain_get

Domein geregistreerd. SPF en tracking zijn al geldig. Ontbreken nog: DKIM — CNAME ss._domainkey → dkim.smtp.software — en een DMARC TXT-record op _dmarc. Zal ik opnieuw controleren zodra ze de records hebben gepubliceerd?