API, publipostage & envoi par e-mail

Envoyez des lettres directement depuis votre logiciel – via l’API REST, en publipostage ou tout simplement par e-mail. Le connecteur Claude utilise les mêmes fonctions.

Authentification

Créez une clé sous Compte → Clés API et transmettez-la comme jeton Bearer. Chaque requête est débitée uniquement du solde de ce compte.

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

Description OpenAPI : https://mcpbrief.de/openapi.json

Points de terminaison

GET	/balance	Solde, tarifs, expéditeur, limite journalière
POST	/letter/price	Vérifier l’adresse, composer la lettre, pages et prix + aperçu PDF (n’envoie rien)
POST	/letter/send	Envoyer une lettre (texte, PDF, DOCX, image ; pièces jointes, recto verso, centre de coûts)
GET	/letter/{id}	Statut et numéro de suivi
POST	/letter/{id}/cancel	Annuler tant que la lettre n’est pas imprimée (remboursement)
POST	/letter/{id}/resend	Renvoyer
GET	/letters?limit=&status=&since=&cost_center=&batch_id=	Liste de vos lettres, filtrable
POST	/letters/batch/price	Vérifier un publipostage : toutes les adresses, champs de fusion, prix total
POST	/letters/batch/send	Envoyer un publipostage (200 destinataires max.)

Exemple : lettre recommandée avec pièce jointe

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

Exemple : publipostage

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

Lettres par e-mail

Sans programmation : chaque compte dispose d’une adresse de commande personnelle. Les PDF que vous envoyez depuis l’e-mail de votre compte à cette adresse partent comme lettres.

Chaque PDF joint = une lettre, adresse dans la zone de fenêtre (DIN 5008)
L’objet pilote les options : Recommandé, Prioritaire, Couleur, Recto verso, Réf : …, Pays : …
« Pièce jointe » dans l’objet : tous les fichiers sont réunis en une seule lettre
« Test » dans l’objet : vérification uniquement et prix par e-mail – rien n’est envoyé

Valeurs de statut

Le point de terminaison de statut, la liste et la notification par e-mail indiquent l’état actuel.

`pending`	en file d’attente
`processing`	en impression et mise sous pli
`mailed`	remise à la Poste
`failed`	non envoyée
`cancelled`	annulée
`undeliverable`	non distribuable
`rejected`	refusée