Afzenderdomeinen

Alle e-mail die via SMTPeter wordt verzonden, wordt verwerkt op basis van de instellingen van het afzenderdomein. Wanneer SMTPeter een e-mail verwerkt, wordt de domeinnaam uit het From-adres gehaald en gebruikt om te bepalen welke instellingen moeten worden toegepast.

Voor ieder domein dat je in het From-adres gebruikt, kun je een aparte configuratie aanmaken. Dit kan via het dashboard of via de REST API.

Via de REST API zijn de volgende endpoints beschikbaar:

(1) https://www.smtpeter.com/v1/domains
(2) https://www.smtpeter.com/v1/domain/NAAM

Afzenderdomeinen aanmaken en bijwerken

Je maakt een afzenderdomein aan met een POST-aanroep:

POST /v1/domain/yourdomain.com?access_token={YOUR_API_TOKEN} HTTP/1.0
Host: www.smtpeter.com

Waarbij yourdomain.com de naam van het afzenderdomein is. Na de aanvraag ontvang je een JSON-object:

{
    "name": "smtpeter-sadfszmnzdhnz.example.com",
    "type": "TXT",
    "value": "asdfwer598459sdFiOTIzYzY5YjVmNDFkYmZlYzBkYjkyYjMzZGRhMDcyMTcxNjAxYwxx"
}

Voordat een afzenderdomein gebruikt kan worden, controleert SMTPeter of je eigenaar bent van het domein. De geretourneerde JSON bevat daarom de gegevens van een TXT-record dat je aan de DNS-configuratie van het domein moet toevoegen.

Zodra het TXT-record is gepubliceerd, detecteert SMTPeter dit automatisch en wordt het afzenderdomein goedgekeurd.

Je kunt bij dezelfde POST-aanroep direct extra instellingen meesturen:

POST /v1/domain/yourdomain.com?access_token={YOUR_API_TOKEN} HTTP/1.0
Host: www.smtpeter.com
Content-Type: application/json

{
    "bounces":      "bounces.yourdomain.com",
    "tracking":     "clicks.yourdomain.com",
    "https":        true,
    "policy":       "none|quarantine|reject",
    "percentage":   100,
    "startdate":    "2026-07-01",
    "enddate":      "2026-08-01",
    "address":      "dmarc@yourdomain.com"
}

Niet alle eigenschappen zijn verplicht. Eigenschappen die je weglaat krijgen automatisch een standaardwaarde.

Bounce en trackingdomeinen

Met de eigenschappen bounces en tracking geef je aan welke subdomeinen worden gebruikt voor bounceverwerking en kliktracking. SMTPeter past tijdens het verzenden de envelopafzender en hyperlinks automatisch aan om bounces, afwezigheidsmeldingen en kliks te kunnen registreren.

De opgegeven hostnamen moeten subdomeinen zijn van het afzenderdomein. Laat je deze eigenschappen weg, dan gebruikt SMTPeter standaard bounces.<afzenderdomein> en clicks.<afzenderdomein>.

Met de eigenschap https bepaal je of trackinglinks via HTTPS of HTTP worden gegenereerd.

DMARC-instellingen

DMARC bepaalt hoe ontvangende mailservers omgaan met e-mails die namens jouw domein zijn verzonden, maar niet kunnen worden geverifieerd. Een bericht kan worden geverifieerd met SPF, DKIM of beide.

SMTPeter genereert de DNS-records voor DMARC, DKIM en SPF. Door deze records aan je DNS-configuratie toe te voegen, kunnen ontvangende mailservers controleren of berichten namens jouw domein aan je DMARC-beleid voldoen.

Met de eigenschap policy bepaal je hoe ontvangende mailservers omgaan met berichten die niet aan je DMARC-beleid voldoen:

• reject weigert deze berichten.
• quarantine plaatst deze berichten bijvoorbeeld in de spammap.
• none past geen aanvullende maatregelen toe.

Met percentage bepaal je voor welk percentage van de berichten de ingestelde DMARC-policy geldt. Zo kun je een strengere policy geleidelijk invoeren.

Je kunt hiervoor ook startdate en enddate opgeven. SMTPeter verhoogt dan automatisch het ingestelde percentage tussen deze twee datums. Stel je bijvoorbeeld policy in op reject, percentage op 100, een startdate van 1 januari en een enddate van 1 februari, dan loopt het percentage gedurende januari geleidelijk op van 0% naar 100%.

E-mail verzenden buiten SMTPeter

Verstuur je ook e-mail via een andere mailserver of applicatie? Dan is het belangrijk om hiermee rekening te houden bij je DMARC-instellingen. Je hebt hiervoor drie mogelijkheden:

• Zorg dat de berichten worden verzonden vanaf een server die is opgenomen in je SPF-record. Dit is de meest gebruikte oplossing.
• Voorzie de berichten zelf van een geldige DKIM-handtekening. Dit is een geavanceerdere oplossing.
• Stel een minder strikte DMARC-policy in, bijvoorbeeld none. Dit is meestal niet de aanbevolen oplossing.

Een extra rapportageadres toevoegen

SMTPeter verwerkt DMARC-rapportages standaard voor je. Wil je daarnaast een externe dienst gebruiken, dan kun je een extra e-mailadres toevoegen via de eigenschap address.

SMTPeter neemt dit adres op in de DMARC-configuratie, zodat ontvangende mailservers ook rapportages naar dit adres kunnen sturen. Je kunt meerdere rapportageadressen toevoegen. Dit is alleen mogelijk nadat het afzenderdomein is gevalideerd.

Gegevens van een afzenderdomein opvragen

Alle instellingen van een afzenderdomein kunnen worden opgevraagd met:

https://www.smtpeter.com/v1/domain/example.com

Dit retourneert onder meer:

{
    "name": "example.com",
    "approved": true,
    "bounces": "bounces.example.com",
    "tracking": "tracking.example.com",
    "https": false,
    "ips": ["1.2.3.4", "2.3.4.5"],
    "policy": "none|quarantine|reject",
    "percentage": 50,
    "startdate": "2016-06-14",
    "enddate": "2016-06-14",
    "addresses": ["dmarc@smtpeter.com"]
}

De eigenschappen komen overeen met de instellingen die je kunt configureren. Daarnaast bevat ips de IP-adressen die SMTPeter gebruikt voor het verzenden van e-mail namens dit domein. addresses bevat alle e-mailadressen waar DMARC-rapportages naartoe worden gestuurd, inclusief dmarc@smtpeter.com.

Overige calls

Methode	Endpoint	Omschrijving
GET	https://www.smtpeter.com/v1/domains	Opvragen van alle afzenderdomeinen
DELETE	https://www.smtpeter.com/v1/domain/yourdomain.com	Verwijderen van een afzenderdomein
DELETE	https://www.smtpeter.com/v1/domain/yourdomain.com/example@email.com	Verwijderen van een DMARC-rapportageadres