API, massutskick & utskick via e-post

Skicka brev direkt från din programvara – via REST-API, som massutskick eller helt enkelt via e-post. Claude-connectorn använder samma funktioner.

Autentisering

Skapa en nyckel under Konto → API-nycklar och skicka den som bearer-token. Varje anrop debiterar bara det kontots saldo.

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

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

Endpoints

GET	/balance	Saldo, priser, avsändare, dagsgräns
POST	/letter/price	Kontrollera adress, skapa brev, sidor och pris + PDF-förhandsgranskning (skickar ingenting)
POST	/letter/send	Skicka ett brev (text, PDF, DOCX, bild; bilagor, duplex, kostnadsställe)
GET	/letter/{id}	Status och spårningsnummer
POST	/letter/{id}/cancel	Avbryt före utskrift (återbetalning)
POST	/letter/{id}/resend	Skicka igen
GET	/letters?limit=&status=&since=&cost_center=&batch_id=	Lista över dina brev, filtrerbar
POST	/letters/batch/price	Kontrollera ett massutskick: alla adresser, platshållare, totalpris
POST	/letters/batch/send	Skicka ett massutskick (max. 200 mottagare)

Exempel: rekommenderat brev med bilaga

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-…"
}'

Exempel: massutskick

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"
}'

Brev via e-post

Ingen programmering behövs: varje konto har en personlig beställningsadress. PDF:er som du skickar från ditt kontos e-post till den adressen skickas som brev.

Varje PDF-bilaga = ett brev, adress i fönsterfältet (DIN 5008)
Ämnesraden styr alternativen: Rekommenderat, Prioriterat, Färg, Duplex, Ref: …, Land: …
”Bilaga” i ämnesraden: alla filer kombineras till ett brev
”Test” i ämnesraden: endast kontroll och priset via e-post – inget skickas

Statusvärden

Status-endpointen, listan och e-postaviseringen visar aktuellt läge.

`pending`	i kö
`processing`	skrivs ut & kuverteras
`mailed`	lämnat till posten
`failed`	inte skickat
`cancelled`	avbrutet
`undeliverable`	kunde inte levereras
`rejected`	avvisat