API, surat massal & pengiriman via email

Kirim surat langsung dari perangkat lunak Anda – melalui REST API, sebagai surat massal, atau cukup via email. Konektor Claude menggunakan fungsi yang sama.

Autentikasi

Buat kunci di Akun → Kunci API dan kirim sebagai bearer token. Setiap permintaan hanya membebani saldo akun tersebut.

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

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

Endpoint

GET	/balance	Saldo, harga, pengirim, batas harian
POST	/letter/price	Periksa alamat, susun surat, halaman dan harga + pratinjau PDF (tidak mengirim apa pun)
POST	/letter/send	Kirim surat (teks, PDF, DOCX, gambar; lampiran, dupleks, pusat biaya)
GET	/letter/{id}	Status dan nomor lacak
POST	/letter/{id}/cancel	Batalkan sebelum dicetak (pengembalian dana)
POST	/letter/{id}/resend	Kirim ulang
GET	/letters?limit=&status=&since=&cost_center=&batch_id=	Daftar surat Anda, dapat difilter
POST	/letters/batch/price	Periksa surat massal: semua alamat, placeholder, total harga
POST	/letters/batch/send	Kirim surat massal (maks. 200 penerima)

Contoh: surat tercatat dengan lampiran

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

Contoh: surat massal

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

Surat via email

Tanpa pemrograman: setiap akun memiliki alamat pesanan pribadi. PDF yang Anda kirim dari email akun ke alamat ini dikirim sebagai surat.

Setiap lampiran PDF = satu surat, alamat di area jendela (DIN 5008)
Perihal mengatur opsi: Registered, Priority, Colour, Duplex, Ref: …, Country: …
“Enclosure” di perihal: semua file digabung menjadi satu surat
“Test” di perihal: hanya pemeriksaan dan harga dikirim via email – tidak ada yang dikirim lewat pos

Nilai status

Endpoint status, daftar, dan notifikasi email menampilkan status terkini.

`pending`	dalam antrean
`processing`	dicetak & dimasukkan ke amplop
`mailed`	diserahkan ke layanan pos
`failed`	tidak terkirim
`cancelled`	dibatalkan
`undeliverable`	tidak dapat diantar
`rejected`	ditolak