SMSForge Anmelden Registrieren
API-Referenz 14 Integrationen 12
Einstieg

SMS-API-Dokumentation

SMSForge verschickt SMS an deutsche Mobilfunknummern per JSON-API oder einfacher GET-URL. Du bekommst eine Nachrichten-ID, den Zustellstatus per Abfrage oder Webhook und kannst jeden Aufruf mit dry=1 erst einmal ohne SMS testen. Kostenlos registrieren

  1. Handynummer bestätigen (Pflicht für die API) und unter API & Konto ein Token anlegen.
  2. SMS senden – am einfachsten per GET-URL oder curl:
curl -g -H "Authorization: Bearer TOKEN" "https://smsforge.de/api/send?to=%2B491711234567&text=Hallo%20Welt"
  1. Antwort 202 mit der Nachrichten-ID – die SMS ist in der Warteschlange und geht in der Regel binnen Sekunden raus.

Gut zu wissen: SMSForge versendet SMS an deutsche Mobilnummern. Antworten auf deine SMS gehen an die SIM-Karte des Gateways, nicht an dich: Es gibt keinen Posteingang für Kunden und keine Weiterleitung. Antwortet jemand mit „STOP“ (auch „ENDE“, „ABMELDEN“ u. ä.), wird seine Nummer automatisch gesperrt, weitere SMS an sie lehnt die API mit 422 ab. Nenne in deinen SMS deshalb einen anderen Rückkanal (Telefonnummer, E-Mail, Link), wenn Empfänger dir antworten sollen. Den Zustellstatus liefern Status-Abfrage und Webhooks.

Basis-Adresse der API: https://smsforge.de/api

Fertige Anleitungen für Home Assistant, Uptime Kuma, Proxmox, SSH-Login, systemd und mehr: Integrationen.

Maschinenlesbar: OpenAPI-Beschreibung (JSON) für Client-Generatoren, Postman und Insomnia.