API, mailmerge & verzenden per e-mail

Verstuur brieven rechtstreeks vanuit uw software – via REST API, als mailmerge of gewoon per e-mail. De Claude-connector gebruikt dezelfde functies.

Authenticatie

Maak een sleutel aan onder Account → API-sleutels en stuur hem mee als bearer token. Elke aanvraag belast alleen het tegoed van dat account.

curl -H "Authorization: Bearer mbx_…" https://mcpbrief.de/api/v1/balance

OpenAPI-beschrijving: https://mcpbrief.de/openapi.json

Endpoints

GET	/balance	Tegoed, prijzen, afzender, daglimiet
POST	/letter/price	Adres controleren, brief opmaken, pagina’s en prijs + PDF-voorbeeld (verstuurt niets)
POST	/letter/send	Brief versturen (tekst, PDF, DOCX, afbeelding; bijlagen, duplex, kostenplaats)
GET	/letter/{id}	Status en track-and-tracecode
POST	/letter/{id}/cancel	Annuleren vóór het printen (terugbetaling)
POST	/letter/{id}/resend	Opnieuw versturen
GET	/letters?limit=&status=&since=&cost_center=&batch_id=	Lijst van uw brieven, filterbaar
POST	/letters/batch/price	Mailmerge controleren: alle adressen, placeholders, totaalprijs
POST	/letters/batch/send	Mailmerge versturen (max. 200 ontvangers)

Voorbeeld: aangetekende brief met bijlage

curl -X POST https://mcpbrief.de/api/v1/letter/send \
  -H "Authorization: Bearer mbx_…" -H "Content-Type: application/json" \
  -d '{
  "recipient": {"name": "Muster GmbH", "street": "Ringstraße 5",
                "zip": "1010", "city": "Wien", "country": "AT"},
  "subject": "Rechnung 2026-17",
  "content": "Sehr geehrte Damen und Herren,\n\nanbei …",
  "attachments": [{"file_base64": "JVBERi0…", "file_name": "rechnung.pdf"}],
  "delivery": "registered", "duplex": true, "cost_center": "VERTRIEB",
  "idempotency_key": "7d1c2f0e-…"
}'

Voorbeeld: mailmerge

curl -X POST https://mcpbrief.de/api/v1/letters/batch/send \
  -H "Authorization: Bearer mbx_…" -H "Content-Type: application/json" \
  -d '{
  "recipients": [
    {"name": "Muster GmbH", "street": "Ringstraße 5", "zip": "1010",
     "city": "Wien", "country": "AT", "anrede": "Sehr geehrte Frau Huber"},
    {"name": "Beispiel AG", "street": "Hauptstraße 1", "zip": "10115",
     "city": "Berlin", "country": "DE", "anrede": "Sehr geehrte Damen und Herren"}
  ],
  "subject": "Preisanpassung 2027",
  "content": "{{anrede}},\n\nab 1. Jänner gelten neue Preise …",
  "delivery": "standard", "idempotency_key": "batch-2027-01"
}'

Brieven per e-mail

Geen programmeerwerk nodig: elk account heeft een persoonlijk opdrachtadres. PDF’s die u vanaf uw account-e-mailadres naar dit adres stuurt, worden als brief verstuurd.

Elke PDF-bijlage = één brief, adres in het venstergedeelte (DIN 5008)
Het onderwerp bepaalt de opties: Aangetekend, Priority, Kleur, Duplex, Ref: …, Land: …
„Bijlage” in het onderwerp: alle bestanden worden samengevoegd tot één brief
„Test” in het onderwerp: alleen controleren en de prijs per e-mail ontvangen – er wordt niets verstuurd

Statuswaarden

Het status-endpoint, de lijst en de e-mailmelding tonen de actuele status.

`pending`	in de wachtrij
`processing`	wordt geprint & gekuverteerd
`mailed`	afgegeven bij de post
`failed`	niet verstuurd
`cancelled`	geannuleerd
`undeliverable`	onbestelbaar
`rejected`	afgewezen