API-documentatie voor ontwikkelaars

Aan de slag

Elk betaald pakket bevat volledige toegang tot de REST API. Genereer een sleutel in je account onder Account → API-sleutels en stuur die mee met elk verzoek:

curl -H "X-Api-Key: YOUR_KEY" https://mailflow.top/api/index.php/lists

Basis-URL: https://mailflow.top/api/index.php · Antwoorden zijn JSON met een status-veld met de waarde success of error. De API is niet beschikbaar in het gratis pakket.

Kernresources

Het platform is compatibel met MailWizz, dus de volledige kern-API — lijsten, abonnees, segmenten, aangepaste velden, campagnes, tracking, sjablonen, transactionele e-mail, bounces, afmeldingen — is interactief gedocumenteerd (OpenAPI) op:

→ Interactieve API-referentie (OpenAPI)

Bestaande MailWizz-SDK's (bijv. de officiële PHP SDK) werken direct — richt ze op de basis-URL hierboven.

AI-endpoints

De AI-functies zijn volwaardige onderdelen van de API. Dezelfde sleutel, dezelfde authenticatie en dezelfde pakketlimieten en creditregistratie als in de webapp.

GET /ai/credits

Je AI-creditmeter voor de huidige maand. Credits gelden per factuurmaand en ongebruikte credits worden niet overgedragen naar de volgende maand.

{"status":"success","data":{"unlimited":false,"limit":750,"used":112,"remaining":638}}

GET /ai/replies

Smart Replies-classificaties voor je campagnes — voed je CRM met wie geïnteresseerd is, wie een vraag stelde en wie klaagde. Filters: category (interested, question, complaint, unsubscribe_request, auto_reply, out_of_office, bounce, other), campaign_uid, since (JJJJ-MM-DD), page, per_page (max. 50).

curl -H "X-Api-Key: YOUR_KEY" \
  "https://mailflow.top/api/index.php/ai/replies?category=interested&since=2026-08-01"

{"status":"success","data":{"count":42,"current_page":1,"per_page":20,"total_pages":3,
  "records":[{"from_email":"[email protected]","subject":"RE: your offer",
    "category":"interested","confidence":98,"engine":"embeddings",
    "summary":"...","suggested_reply":"...","date_added":"2026-08-24 18:21:19",
    "campaign_uid":"py794hjqk8a8d"}]}}

GET /ai/tiers

AI-betrokkenheidsniveaus (vip, engaged, passive, at_risk, dormant) per lijst — dezelfde scoring die autopilot en win-back aanstuurt.

{"status":"success","data":{"records":[
  {"list_uid":"qk661oq7nl8c1","name":"Main list","tiers":{"engaged":1200,"passive":3400,"dormant":900}}]}}

POST /ai/subject-lines

Genereer onderwerpregels in elke taal. Body: topic (verplicht), count (1–5, standaard 3), language (optioneel). Verbruikt AI-credits, net als de webeditor.

curl -X POST -H "X-Api-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"topic":"Summer sale for B2B customers","count":3,"language":"Greek"}' \
  https://mailflow.top/api/index.php/ai/subject-lines

{"status":"success","data":{"subjects":["...","...","..."],"credits_remaining":636}}

GET /ai/flows · POST /ai/flows/author · POST /ai/flows/<uid>/enroll · POST /ai/flows/<uid>/status

AI Flow Builder via de API: bekijk je flows met live tellers; laat de AI een complete flow opstellen op basis van een doel in gewone taal ({"goal":"...","list_uid":"..."} — geeft een concept terug dat je activeert met {"status":"active"}); zet een abonnee in een flow ({"email":"..."}).

curl -X POST -H "X-Api-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"goal":"When someone replies interested, notify me, wait 2 days, then send a case study"}' \
  https://mailflow.top/api/index.php/ai/flows/author

Fouten en limieten

401 — ontbrekende of ongeldige X-Api-Key
403 — de functie zit niet in je pakket
422 — ontbrekende/ongeldige parameters
429 — AI-creditlimiet of maandelijks AI-tegoed bereikt; wordt gereset op je volgende factuurdatum

Pieken worden per sleutel afgeremd — implementeer exponentiële backoff bij 429. Vragen? Neem contact met ons op of open een supportticket.

API voor ontwikkelaars