Verstuur je eerste e-mail met Inbixio in 5 minuten

Inbixio maakt van het e-mailaccount dat je al hebt een overzichtelijke HTTPS-API, beveiligd met sleutels. In plaats van vanuit elke service die je draait SMTP-verbindingen te openen, doet je code één POST-verzoek en regelt Inbixio de communicatie met je mailserver.

Deze gids brengt je van een nieuw account tot een afgeleverde e-mail. Je hebt ongeveer vijf minuten nodig, een e-mailaccount dat SMTP ondersteunt (een mailbox van Google Workspace, Microsoft 365, Zoho of je hostingprovider werkt allemaal) en een terminal.

Hoe Inbixio in je stack past

Voordat we aan de stappen beginnen, is het handig om de onderdelen te zien:

1. Je app stuurt een JSON-verzoek met een API-sleutel naar de Inbixio-API.
2. Inbixio controleert de sleutel, de rechten ervan en de maandlimiet van je abonnement, en zet het bericht dan in de wachtrij.
3. Je SMTP-server (die je in stap 2 koppelt) levert het af. Inbixio logt in, schakelt de verbinding over op TLS en draagt het bericht over.
4. Je dashboard toont hoeveel e-mails er zijn verstuurd, welk deel is mislukt en hoe lang je server erover deed om ze te accepteren.

Omdat het bericht via je eigen mailserver de deur uitgaat, wordt het verstuurd vanaf je eigen adres en domein, en blijft de reputatie die je bij inboxproviders hebt opgebouwd van jou.

Stap 1: Maak je account aan en kies een abonnement

Ga naar app.inbixio.com/create-account en vul je naam, e-mailadres, bedrijfsnaam, telefoonnummer en zakelijk adres in. Kies daarna een wachtwoord.

Inbixio stuurt een verificatielink naar het adres dat je hebt opgegeven. Open die en log in. De eerste keer dat je inlogt, wordt je gevraagd een abonnement te kiezen; de betaling wordt veilig afgehandeld door Stripe. Abonnementen verschillen vooral in maandelijks volume. Weet je niet zeker welk je nodig hebt, lees dan hoe je je e-mailvolume schat.

Stap 2: Koppel je SMTP-server

Open in het dashboard Email Servers (e-mailservers) en kies Add Server (server toevoegen). Je ziet vier velden en twee schakelaars:

Twee details schelen je later veel debugwerk:

• De gebruikersnaam is ook je afzender. Inbixio verstuurt vanaf het adres waarmee je inlogt, dus gebruik een echte mailbox op je eigen domein, zoals hello@ of notifications@, en geen persoonlijke inbox.
• Veel providers vereisen een app-wachtwoord. Google vereist bijvoorbeeld verificatie in twee stappen en een app-wachtwoord van 16 tekens voor SMTP. Je normale wachtwoord wordt geweigerd.

Weet je niet wat je moet invullen? SMTP-instellingen uitgelegd behandelt hosts, poorten en TLS voor de meest gebruikte providers.

Stap 3: Genereer een API-sleutel

Open API Keys (API-sleutels) en kies Create Api Key (API-sleutel aanmaken). Geef de sleutel een naam die aangeeft waar hij komt te staan, bijvoorbeeld production-backend of staging-signup-service, en stel daarna in:

• Server Access (servertoegang): All Server (alle servers) verstuurt via de eerste e-mailserver die je hebt gekoppeld. Selected Server (geselecteerde server) zet de sleutel vast op één server. Heb je meer dan één verzendadres, geef elke service dan een sleutel die vastgezet is op zijn eigen server; zo bepaal je vanaf welk adres hij verstuurt.
• Permissions (rechten): vink Send (versturen) aan zodat de sleutel e-mail kan versturen. Geef een sleutel alleen de rechten die hij nodig heeft.

Kies Generate API Key (API-sleutel genereren) en kopieer de sleutel. Inbixio-sleutels beginnen met ibx_. Bewaar hem als een wachtwoord: in je secrets manager of een omgevingsvariabele, nooit in frontendcode of een openbare repository. Beveiliging van API-sleutels gaat dieper in op rotatie en het beperken van rechten.

Stap 4: Verstuur je eerste e-mail

Exporteer de sleutel en verstuur een verzoek met curl:

export INBIXIO_API_KEY="ibx_your_key_here"

curl -X POST https://backend.inbixio.com/api/send-email/ \
  -H "X-API-Key: $INBIXIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to_email": "you@example.com",
    "subject": "Hello from Inbixio",
    "message": "<h1>It works!</h1><p>My first email sent through the Inbixio API.</p>"
  }'

Een geslaagd verzoek geeft HTTP 200 terug:

{ "message": "Email queued successfully." }

Kijk in je inbox. De e-mail komt binnen vanaf het adres dat je als SMTP-gebruikersnaam hebt ingesteld.

Laat de slash aan het eind staan. Het endpoint is /api/send-email/. Zonder de laatste / antwoordt de server met een redirect, en veel HTTP-clients sturen de request body na een redirect niet opnieuw mee.

De request body heeft drie verplichte velden:

Stap 5: Controleer de bezorging in het dashboard

“In de wachtrij” betekent dat Inbixio het verzoek heeft geaccepteerd en de bezorging op de achtergrond is gestart. De SMTP-bezorging volgt even later, en de resultaten worden opgeteld op je Dashboard:

• Email Sent (verzonden e-mails) telt de geslaagde verzendingen van de afgelopen 7 dagen.
• Failed Deliveries (mislukte bezorgingen) toont het aandeel e-mails dat je SMTP-server in dezelfde 7 dagen heeft geweigerd.
• Avg Latency (gemiddelde latency) toont hoe lang je SMTP-server erover doet om berichten te accepteren.
• De tabel met logs (logboeken) toont elke API-aanroep met event-ID, endpoint, statuscode en responstijd.

Komt je testmail niet aan en stijgt het percentage mislukkingen, dan zit de oorzaak bijna altijd in de serverinstellingen: een verkeerd wachtwoord, een provider die een app-wachtwoord wil, of de verkeerde host of poort. Controleer ze onder Email Servers en verstuur nog een test.

Veelvoorkomende fouten bij het eerste verzoek

Voor retries, maandlimieten en foutafhandeling op productieniveau, zie fouten en limieten van de e-mail-API afhandelen.

Hoe verder

Je hebt nu een werkende pijplijn van je code naar de inboxen van je gebruikers. Vanaf hier:

• Verstuur vanuit je echte stack met de voorbeelden voor Node.js, Python en cURL.
• Zorg dat je berichten in de inbox belanden met de checklist voor SPF, DKIM en DMARC.
• Bouw de e-mails waar gebruikers op wachten: OTP- en verificatiecodes en wachtwoordresets.