Dokumentacja

API, które rozumiesz bez czytania PDF-a.

Wszystko, co potrzebne, żeby wysłać pierwszego SMS-a w 5 minut. Pełna referencja, gotowe biblioteki, przykłady w 5 językach.

Quickstart

1. Załóż konto

Rejestracja przez e-mail. 100 SMS gratis na start, bez podawania karty.

2. Wygeneruj Bearer Token

Panel → Ustawienia → API → Generuj. Zapisz token w bezpiecznym miejscu.

3. Wyślij pierwszy SMS

POST na /api/sms z payloadem JSON. Code samples niżej.

Endpoint: POST /api/sms

Główny endpoint wysyłki. Akceptuje JSON, zwraca message ID i status. Idempotency Key opcjonalny.

Base URL

https://msg-api.actio.pl

Pola request

fromstringrequired
Sender ID (alphanumeryczny do 11 znaków lub numer w formacie E.164).
tostringrequired
Numer odbiorcy w formacie E.164 bez '+' (np. 48732129000).
bodystringrequired
Treść SMS-a. UTF-8. Maksymalnie 1530 znaków (10 segmentów).
scheduled_atISO 8601
Wysyłka zaplanowana w przyszłości.
idempotency_keystring
UUID v4. Gwarantuje, że ten sam request wyśle SMS tylko raz.

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

Kody błędów

401

Unauthorized

Brak lub nieprawidłowy Bearer Token.

402

Insufficient Credits

Brak środków na koncie. Doładuj w panelu.

422

Validation Error

Nieprawidłowy numer, za długi body, niedozwolone znaki w sender.

429

Rate Limit Exceeded

Zbyt wiele requestów. Zobacz nagłówek Retry-After.

500

Internal Server Error

Problem po naszej stronie. Spróbuj ponownie za 30s. Jeśli się powtarza – napisz.

Webhooki

Konfigurujesz URL w panelu. Wysyłamy POST z payloadem JSON przy każdej zmianie statusu SMS-a.

sms.deliveredSMS dostarczony do odbiorcy.

sms.failedNieudane dostarczenie – z podanym reason.

sms.expiredSMS nie został dostarczony przez 48h.

sms.bouncedNumer nieaktywny lub nieosiągalny.

{
  "event": "sms.delivered",
  "message_id": "msg_01HQX7Z8RNQK5ZF8TBPNT2YFKA",
  "to": "48732129000",
  "delivered_at": "2026-05-15T14:23:47.291Z",
  "operator": "Orange Polska",
  "segments": 1
}

Zacznij wysyłać SMS-y dzisiaj.

100 wiadomości gratis. Bez karty kredytowej. Bez abonamentu. Aktywacja w 30 sekund.

Załóż darmowe konto Porozmawiaj z nami