Przejdź do treści
SENDLY by ACTIOSENDLY by ACTIO
Dokumentation

Eine API, die Sie ohne PDF-Lektüre verstehen.

Alles, was Sie brauchen, um Ihre erste SMS in 5 Minuten zu senden. Vollständige Referenz, fertige Bibliotheken, Beispiele in 5 Sprachen.

Quickstart

1. Konto erstellen

Registrierung per E-Mail. 100 SMS gratis zum Start, keine Kreditkarte erforderlich.

2. Bearer-Token generieren

Panel → Einstellungen → API → Generieren. Token sicher speichern.

3. Erste SMS senden

POST /api/sms mit JSON-Payload. Code-Beispiele unten.

Endpoint: POST /api/sms

Haupt-Sende-Endpoint. Akzeptiert JSON, gibt Message ID und Status zurück. Idempotency-Key optional.

Base URL

https://msg-api.actio.pl

Pola request

  • fromstringrequired

    Sender-ID (alphanumerisch bis 11 Zeichen oder E.164-Nummer).

  • tostringrequired

    Empfängernummer im E.164-Format ohne '+' (z. B. 48732129000).

  • bodystringrequired

    SMS-Text. UTF-8. Bis zu 1530 Zeichen (10 Segmente).

  • scheduled_atISO 8601

    Geplanter Sendezeitpunkt.

  • idempotency_keystring

    UUID v4. Garantiert, dass derselbe Request nur einmal sendet.

curl -X POST https://msg-api.actio.pl/api/sms \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "FirmaXYZ",
    "to": "48732129000",
    "body": "Twój kod logowania: 482910"
  }'

Fehlercodes

401
Unauthorized
Fehlender oder ungültiger Bearer-Token.
402
Insufficient Credits
Keine Mittel auf dem Konto. Im Panel aufladen.
422
Validation Error
Ungültige Nummer, Body zu lang, unzulässige Zeichen im Sender.
429
Rate Limit Exceeded
Zu viele Requests. Siehe Retry-After-Header.
500
Internal Server Error
Problem auf unserer Seite. Retry in 30 s. Bei anhaltendem Problem – schreiben Sie uns.

Webhooks

URL im Panel konfigurieren. Wir senden JSON-POST an Ihren Endpoint bei jeder SMS-Statusänderung.

sms.deliveredSMS an Empfänger zugestellt.
sms.failedZustellung fehlgeschlagen – mit Grund.
sms.expiredSMS innerhalb von 48 h nicht zugestellt.
sms.bouncedNummer inaktiv oder nicht erreichbar.
{
  "event": "sms.delivered",
  "message_id": "msg_01HQX7Z8RNQK5ZF8TBPNT2YFKA",
  "to": "48732129000",
  "delivered_at": "2026-05-15T14:23:47.291Z",
  "operator": "Orange Polska",
  "segments": 1
}

Beginnen Sie heute mit dem SMS-Versand.

100 SMS gratis. Keine Kreditkarte. Kein Abo. Aktivierung in 30 Sekunden.