Aan de slag met de Flexmail transactionele API

Met de Flexmail transactionele API kun je getriggerde, één-op-één-e-mails versturen vanuit je applicatie — orderbevestigingen, wachtwoordresets, facturen en alles wat wordt geactiveerd als reactie op een specifieke gebruikersactie. Je kunt verzenden via HTTP (REST API) of SMTP, waarbij je dezelfde account en inloggegevens voor beide gebruikt.

Het transactionele product werkt onafhankelijk van het Flexmail-marketingproduct. Je kunt het zelfstandig gebruiken zonder campagnes of contactenlijsten in te stellen.

Opgelet De transactionele API ondersteunt slechts één ontvanger per bericht. Het kan niet worden gebruikt voor bulk- of marketingverzendingen. Zie "Marketing-e-mail vs. transactionele e-mail" voor de volledige uitleg.

Vereisten

  • Een Flexmail-account. Je hebt er één nodig om de transactionele API te gebruiken, zelfs als je alleen transactionele e-mail verstuurt en de marketingfuncties niet gebruikt.
  • Toegang tot de DNS-instellingen van je domein om e-mailverificatie te configureren.
  • Ontwikkelaarstoegang tot je applicatie of verzendsysteem om de API te integreren of SMTP te configureren.

Stap 1: Het transactionele product activeren

Als je al een Flexmail-account hebt, activeer dan de transactionele module via de dashboardwidget. De proefperiode geeft je tot 1.000 verzendingen over 30 dagen zonder kosten. Je kunt op elk moment tijdens of na de proefperiode upgraden naar een betaald transactioneel abonnement.

Als je nog geen account hebt, registreer je dan op flexmail.be/nl/registreren. Je marketing- en transactionele abonnementen worden beheerd vanuit hetzelfde account.

Opgelet Je hebt geen marketingabonnement nodig om het transactionele product te gebruiken. Als je alleen transactionele e-mail wilt versturen, kun je de transactionele module activeren en de marketingfuncties ongebruikt laten.

Stap 2: Je afzenderadres verifiëren

Voordat je kunt verzenden, moet je het e-mailadres verifiëren dat je in het Van-veld wilt gebruiken.

  1. Ga naar Instellingen, vervolgens naar Afzenders toevoegen of verwijderen.
  2. Voeg het e-mailadres toe waarvan je wilt verzenden.
  3. Flexmail stuurt een verificatie-e-mail naar dat adres — klik op de link om te bevestigen. Dit bewijst dat je de mailbox beheert waarvan je verstuurt.


Stap 3: E-mailverificatie instellen

Configureer SPF, DKIM, DMARC en een aangepast return-path voor het domein van je afzenderadres. Deze DNS-records bewijzen dat je e-mails daadwerkelijk van jou afkomstig zijn, en op basis daarvan beslissen inboxproviders zoals Gmail of ze je e-mail in de inbox bezorgen of weigeren.

Gedetailleerde instructies voor DNS-configuratie staan in de Flexmail Email API-documentatie, onder de sectie Email authentication.

Opgelet E-mailverificatie is niet optioneel voor transactionele e-mail. Zonder correct geconfigureerde SPF- en DKIM-records mislukken je transactionele e-mails de verificatiecontroles bij grote inboxproviders en kunnen ze worden geweigerd of als spam worden aangemerkt.

Stap 4: Een persoonlijk toegangstoken aanmaken

De transactionele API maakt gebruik van HTTP Basic-authenticatie. Je account-ID is de gebruikersnaam; een personal access token is het wachtwoord. Deze inloggegevens zijn alleen voor de HTTP API — SMTP gebruikt afzonderlijke inloggegevens die Flexmail op aanvraag verstrekt.

  1. Ga naar Instellingen, en vervolgens in de API sectie naar Personal access tokens.
  2. Klik op Nieuw token aanmaken en geef het een beschrijvende naam.
  3. Kopieer het token en bewaar het veilig. Het wordt niet opnieuw getoond.

Stap 5: Je verzendmethode kiezen

Flexmail ondersteunt twee manieren om transactionele e-mail te versturen. Beide gebruiken dezelfde account-ID en hetzelfde persoonlijke toegangstoken.

HTTP API

De REST API geeft je de meeste controle. Je kunt berichten versturen, templates beheren, Webhooks afhandelen en leveringsdata programmatisch ophalen. Dit is de aanbevolen aanpak voor aangepaste integraties en applicaties.

Volledige documentatie is beschikbaar op email-api.flexmail.eu/documentation. De sectie Aan de slag bevat een curl-voorbeeld dat je onmiddellijk kunt uitvoeren om je configuratie te verifiëren.

SMTP

SMTP-verzendingen zijn inbegrepen in het transactionele product zonder extra kosten. Gebruik SMTP wanneer je applicatie of platform dit al ondersteunt — bijvoorbeeld een CMS, een e-commerceplatform of een legacy-systeem dat e-mail verstuurt via een SMTP-relay.

Zie "SMTP-verzendingen voor transactionele e-mail" voor de verbindingsinstellingen en configuratie-instructies.

Stap 6: Integreren in je applicatie

Nu een succesvolle testverzending is bevestigd, ben je klaar om de API te integreren in je applicatie. De volledige documentatie behandelt:

  • Berichtverzending: alle parameters voor het verzend endpoint
  • Webhooks — realtime-gebeurtenismeldingen voor verzendingen, leveringen, bounces, openingen en klikken. Zie "Transactionele Webhooks" voor de configuratie en gebeurtenisreferentie.

Support tip Stel Webhook-afhandeling vroeg in je integratie in. Weten wanneer een transactionele e-mail bounced, stelt je in staat onmiddellijk actie te ondernemen — het adres markeren in je systeem, een opvolgmelding activeren of je team waarschuwen — in plaats van een leveringsprobleem dagen later te ontdekken.

API-documentatie en ondersteuning

Volledige API-documentatie is beschikbaar op email-api.flexmail.eu/documentation.

Als je ergens vastloopt, is het Flexmail-supportteam bereikbaar via support@flexmail.eu. Vragen over de transactionele API worden behandeld door hetzelfde team dat de marketinginterface ondersteunt.

Volgende stappen

Heeft dit je vraag beantwoord? Bedankt voor je feedback Er is een probleem opgetreden bij het registreren van je feedback. Probeer het later opnieuw.

Nog niet gevonden waar je naar op zoek was Contacteer ons Contacteer ons