Avsändare och inställningar

Registrera egna avsändare och konfigurera kontots SMS-relaterade inställningar innan de används i produktionsflödet.

Förutsättningar för avsändare

En egen avsändare kräver ett aktivt abonnemang eller tjänsten för valfri avsändare. På testkonto används de avsändare som kontot redan tillhandahåller.

Alfanumeriska avsändare ska bestå av 3–11 tecken från A–Z, a–z och 0–9. Numeriska avsändare följer E.164 och får vara högst 15 siffror. Operatörs- och landsregler kan begränsa vilka avsändare som levereras.

Endpoints för avsändare

Metod	Sökväg	Beskrivning
GET	/v2/me/senders	Lista registrerade avsändare.
GET	/v2/me/senders/{sender}	Läs en avsändare.
PUT	/v2/me/senders/{sender}	Registrera en avsändare.
DELETE	/v2/me/senders/{sender}	Avregistrera en avsändare.

curl -X PUT "https://api.ip1sms.com/v2/me/senders/DittForetag" \
  -H "Authorization: Bearer $IP1_TOKEN"

{
  "sender": "DittForetag",
  "created": "2026-10-05T08:03:21Z"
}

Den äldre quickstarten visade alternativt PUT /v2/me/senders med { "sender": "..." }, medan endpointlistan och språkexemplen använder sökvägsparametern. Dokumentationen använder den senare formen. Bekräfta collection-varianten i testmiljö innan den används.

Kontoinställningar

Metod	Sökväg	Beskrivning
GET	/me/sms/settings	Lista alla SMS-inställningar.
GET	/me/sms/settings/{setting}	Läs en inställning.
PUT	/me/sms/settings/{setting}	Skapa eller ersätt en inställning.
DELETE	/me/sms/settings/{setting}	Återställ till global standard eller inaktivera.

Kontoinställningarnas endpoints tillhör en äldre, fortfarande operativ API-struktur och ligger direkt under https://api.ip1sms.com, utan /v2.

Callback för inkommande SMS

Egenskap	Värde
Namn	IncomingCallbackUrl
Datatyp	Absolut URL som string
Standard	null, inaktiverad

Exempel:

curl -X PUT \
  "https://api.ip1sms.com/me/sms/settings/IncomingCallbackUrl" \
  -H "Authorization: Bearer $IP1_TOKEN" \
  -H "Content-Type: application/json" \
  -d '"https://example.com/webhooks/ip1/incoming"'

Den publicerade inställningssidan anger inte exakt request-wrapper för värdet. Testa därför payloadformen på ett icke-produktionskonto eller konfigurera URL:en i portalen innan automatisk inställningshantering tas i drift.

Läs Inkommande SMS för payload och mottagarens beteende.