SMS8 API voor ontwikkelaars.
Verstuur sms en mms via de SMS8 API en ze vertrekken vanaf je eigen telefoon. Eén API-sleutel voor elk endpoint, webhooks voor antwoorden en afleverrapporten, een SDK voor Node, kant-en-klare PHP- en C#-klassen, en een MCP-server voor AI-agents.

npm install sms8-sdkclaude mcp add --transport http sms8 https://mcp.sms8.ioSMS8_API_KEY=your_api_key npx -y sms8-sdk mcphttps://mcp.sms8.ioClaude Desktop: Instellingen, Connectors, Aangepaste connector toevoegen
Zo werkt de API
Elk verzoek gaat naar app.sms8.io. Je verstuurt een eenvoudige form post met je API-sleutel en de velden die je nodig hebt. Je krijgt JSON terug, met een duidelijke success-vlag en de details van het bericht.
Daarachter gaat het bericht naar een Android-telefoon die je hebt gekoppeld, en die telefoon verstuurt het vanaf zijn eigen simkaart. Antwoorden en afleverrapporten komen op dezelfde manier bij je terug.
De API heeft geen kunstmatige rate limit. De echte doorvoer hangt af van je simkaarten. Voeg telefoons toe of gebruik een dual-sim telefoon om meer te versturen.
Wat je kunt doen
Eén endpoint per taak. De volledige referentie noemt elk veld.
Sms en mms versturen
Verstuur één bericht, een batch naar veel mensen, of een broadcast naar een opgeslagen contactlijst. Voeg afbeeldingslinks toe voor mms. Plan een verzending in voor later, of geef hem voorrang in de wachtrij.
Kies de afzender
Verstuur vanaf één telefoon en simkaart, wissel af tussen al je telefoons, of kies er per bericht een willekeurige om de belasting te spreiden.
Lezen en opnieuw versturen
Zoek elk bericht op via zijn ID om de status te zien. Zet mislukte berichten met één aanroep terug in de wachtrij.
OTP-codes
Verstuur een eenmalige code en controleer wat de gebruiker typte. Codes zijn per telefoonnummer per dag begrensd om ontvangers te beschermen.
Toestellen en contacten
Toon je gekoppelde telefoons en hun simkaarten. Maak contacten aan of werk ze bij met een naam, tags en eigen velden.
USSD
Verstuur een USSD-code van je provider, zoals een saldocheck, vanaf een gekoppelde telefoon en lees het antwoord.
Authenticatie en antwoorden
Eén sleutel per account, dezelfde vorm van antwoord bij elke aanroep.
Waar de sleutel staat
Je sleutel staat op de API-pagina van je SMS8-dashboard. Behandel de sleutel als een wachtwoord en bewaar hem op je server, niet op een openbare webpagina.
Hoe je hem meestuurt
Zet hem in de X-Api-Key-header, zoals in het OpenAPI-bestand staat. Een bearer token in de Authorization-header of een formulierveld met de naam key werken ook.
Wat je terugkrijgt
JSON met een success-vlag. Bij succes krijg je het bericht of het record. Bij een fout krijg je een error met een code en een korte melding.
Controleer de vlag
Sommige fouten, zoals verkeerde velden of geen tegoed meer, komen terug in een normaal antwoord. Lees de success-vlag voordat je op het resultaat vertrouwt.
Als de sleutel niet klopt
Een ontbrekende of ongeldige sleutel geeft 401 terug. Velden die ontbreken of verkeerd zijn opgemaakt geven 400 terug.
Endpoints in één oogopslag
Allemaal onder app.sms8.io. Het OpenAPI-bestand heeft de exacte velden voor elk endpoint.
| Pad | Methode | Wat het doet |
|---|---|---|
| /api/v1/messages | POST | Verstuur een sms of mms naar één persoon of een batch |
| /api/v1/messages/read | POST | Toon verstuurde en ontvangen berichten, gefilterd op nummer, richting of datum |
| /api/v1/messages/resend | POST | Probeer een mislukt bericht opnieuw, via zijn ID |
| /api/v1/devices | GET | Toon gekoppelde telefoons met batterij, bereik, simkaarten en laatst gezien |
| /api/v1/contacts | POST | Maak een contact aan of werk het bij met tags en eigen velden |
| /api/v1/ussd/send | POST | Voer een USSD-code uit vanaf een gekoppelde simkaart en krijg het antwoord van de provider |
| /api/v1/ussd/list | POST | Toon je recente USSD-sessies |
Een bericht versturen, veld voor veld
Alleen het nummer en de tekst zijn verplicht. Al het andere heeft een standaardwaarde.
Nummer en tekst
Het nummer staat in internationaal formaat, zoals +14155550100. De tekst mag tot 1.000 tekens lang zijn en samenvoegvelden zoals {first_name} gebruiken.
Sms of mms
Het type is standaard sms. Voeg voor mms openbare HTTPS-links naar afbeeldingen toe. SMS8 verkleint elke afbeelding tot 1.280 pixels voor het versturen.
Welke telefoon het verstuurt
Geef een of meer toestel-ID's en een simslot op, waarbij 0 sim 1 is en 1 sim 2. Laat je ze weg, dan verstuurt je standaardtelefoon.
Afwisselen
Stel de optie in om af te wisselen tussen al je telefoons, of tussen elke simkaart op elke telefoon. Een willekeurige telefoon per bericht kan ook.
Voorrang in de wachtrij
Markeer een bericht als prioriteit en het gaat voor andere berichten die op die telefoon wachten. Handig voor meldingen en codes.
Wat je terugkrijgt
Een bericht-ID om later op te zoeken, de telefoon en simkaart die het overnamen, en het tijdstip waarop het in de wachtrij kwam. De status gaat daarna van queued naar sending, sent, delivered of failed.
Webhooks
Registreer een URL en SMS8 stuurt gebeurtenissen ernaartoe zodra ze plaatsvinden. Elke webhook kiest zijn eigen gebeurtenissen en krijgt een eigen ondertekeningsgeheim, zodat je kunt controleren dat elk verzoek echt van SMS8 komt.
Ontvangen
Er kwam een antwoord of nieuw bericht binnen op een van je telefoons. De gebeurtenis die de meeste CRM-opstellingen nodig hebben.
Verstuurd
Je telefoon heeft het bericht overgenomen en op zijn simkaart in de wachtrij gezet. Goed voor auditlogs.
Afgeleverd
De provider van de ontvanger heeft de aflevering bevestigd.
Mislukt
Het bericht kon na nieuwe pogingen niet worden verstuurd, bijvoorbeeld door een verkeerd nummer of geen bereik.
USSD-antwoord
De provider heeft geantwoord op een USSD-code die je verstuurde.
Telefoon gekoppeld
Er is een nieuwe telefoon aan je account toegevoegd.
Ondertekend, opnieuw geprobeerd en gelogd
Elk webhookverzoek heeft een X-Signature-header. Dat is een HMAC-SHA256-hash van de ruwe body van het verzoek, gemaakt met het eigen geheim van die webhook, niet met je API-sleutel. Bereken dezelfde hash op je server, vergelijk de twee met een constant-time controle, en gooi alles weg wat niet overeenkomt.
Je ontvanger moet HTTPS gebruiken en hoort binnen 10 seconden te antwoorden met een 2xx-status. Gebeurt dat niet, dan probeert SMS8 het opnieuw volgens een schema dat oploopt van een paar minuten tot 30 dagen. Elke poging staat in het afleverlog met de status en het antwoord, en je kunt elke rij met de hand opnieuw proberen.
Antwoord eerst en doe traag werk later, zoals opzoeken in je CRM of classificatie met AI. Gebruik het bericht-ID als unieke sleutel, zodat een opnieuw verstuurde gebeurtenis nooit twee keer wordt verwerkt.
SDK's en talen
Elke taal die een webverzoek kan doen, werkt. Deze besparen je het instellen.
Node en TypeScript
Installeer sms8-sdk via npm. Eén pakket voor de SDK, een command line tool, React-hulpmiddelen en de MCP-bridge.
02PHP
Eén PHP-klasse met een methode voor elk endpoint. Sla het bestand op, require het en verstuur. Draait op PHP 7.4 en nieuwer en heeft alleen de curl-extensie nodig, dus het past in Laravel, WordPress, Symfony of een gewoon script.
03C# en .NET
Eén klasse gebouwd op HttpClient met async-methoden. Draait op modern .NET, .NET Framework 4.6.2 en nieuwer, Unity, Xamarin en MAUI.
04Python en andere talen
De referentie toont elk verzoek klaar om te kopiëren in jouw taal. Met de builder in het dashboard probeer je een verzoek uit op je echte account.
Voor AI-agents
Met de SMS8 MCP-server op mcp.sms8.io kunnen Claude, Cursor en andere AI-tools sms versturen, OTP-codes versturen en controleren, berichten lezen, je telefoons tonen en webhooks instellen.
Hij gebruikt dezelfde API-sleutel, meegestuurd als bearer token. Voeg hem één keer toe aan je AI-tool en je agent kan sms'en vanaf je nummer.
Volledige referentie
Alles met exacte velden, antwoorden en foutcodes vind je hier.
API-referentie
Elk endpoint, veld en elke foutcode, met een builder om verzoeken op je account uit te proberen.
Open de referentieOpenAPI-bestand
Importeer de specificatie in Postman, Insomnia of je codegenerator.
Download openapi.yamlWebhookinstellingen
Voeg een webhook-URL toe, kies gebeurtenissen en bekijk het afleverlog.
Open webhooksStuur je API-sleutel mee met elk verzoek. Je vindt hem op de API-pagina van je dashboard. De MCP-server neemt dezelfde sleutel aan als bearer token.
De API heeft geen kunstmatige limiet. Je simkaarten bepalen het echte tempo. Voor grote verzendingen voeg je telefoons toe of stel je in je instellingen een pauze tussen berichten in.
Abonneer een webhook op de gebeurtenissen delivered en failed, of zoek het bericht op via zijn ID.
Ja. Zet het type op MMS en voeg openbare links naar afbeeldingen toe. SMS8 verkleint de afbeeldingen voor het versturen.
Ja. De huidige endpoints staan onder /api/v1, en de oudere URL's blijven werken voor bestaande apps.
Nee. Elke webhook heeft een eigen ondertekeningsgeheim, ingesteld als je hem aanmaakt. Je API-sleutel verlaat nooit je verzoeken aan SMS8.
Gebeurtenissen wachten in de wachtrij voor nieuwe pogingen en SMS8 blijft het tot 30 dagen proberen. Je kunt ook elke aflevering opnieuw versturen vanuit het log zodra je weer online bent.
Ja. Importeer het OpenAPI-bestand in Postman, Insomnia of een codegenerator om elk endpoint en veld te krijgen.
Ja. Geef een toestel-ID en een simslot mee, of laat SMS8 afwisselen tussen je telefoons en simkaarten om de belasting te spreiden.
Verstuur je eerste API-aanroep
Maak een account aan, koppel een telefoon en kopieer je API-sleutel. Je code kan binnen een paar minuten versturen.