API de SMS8 para desarrolladores.
Envía SMS y MMS con la API de SMS8 y salen de tu propio teléfono. Una clave de API para todos los endpoints, webhooks para respuestas e informes de entrega, un SDK para Node, clases listas para PHP y C#, y un servidor MCP para agentes de IA.

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: Ajustes, Conectores, Añadir conector personalizado
Cómo funciona la API
Cada petición va a app.sms8.io. Envías un formulario sencillo con tu clave de API y los campos que necesitas. Recibes JSON, con un indicador de éxito claro y los detalles del mensaje.
Por detrás, el mensaje va a un teléfono Android que vinculaste, y ese teléfono lo envía desde su propia SIM. Las respuestas y los informes de entrega te vuelven por el mismo camino.
La API no tiene un límite artificial de peticiones. El ritmo real depende de tus SIM. Añade teléfonos o usa uno con doble SIM para enviar más.
Qué puedes hacer
Un endpoint para cada tarea. La referencia completa lista cada campo.
Enviar SMS y MMS
Envía un mensaje, un lote a muchas personas o una difusión a una lista de contactos guardada. Añade enlaces de imagen para MMS. Programa un envío para más tarde, o haz que pase por delante en la cola.
Elegir el remitente
Envía desde un teléfono y una SIM, rota entre todos tus teléfonos, o elige uno al azar por mensaje para repartir la carga.
Consultar y reenviar
Busca cualquier mensaje por ID para ver su estado. Vuelve a poner en cola los mensajes fallidos con una sola llamada.
Códigos OTP
Envía un código de un solo uso y comprueba lo que escribió el usuario. Los códigos tienen un límite por número al día para proteger a los destinatarios.
Dispositivos y contactos
Lista tus teléfonos vinculados y sus SIM. Crea o actualiza contactos con un nombre, etiquetas y campos personalizados.
USSD
Envía un código USSD del operador, como una consulta de saldo, desde un teléfono vinculado y lee la respuesta.
Autenticación y respuestas
Una clave por cuenta, la misma forma de respuesta en cada llamada.
Dónde está la clave
Tu clave aparece en la página API de tu panel de SMS8. Trátala como una contraseña y guárdala en tu servidor, no en una página web pública.
Cómo enviarla
Ponla en la cabecera X-Api-Key, como muestra el archivo OpenAPI. También funcionan un token bearer en la cabecera Authorization o un campo de formulario llamado key.
Qué recibes
JSON con un indicador de éxito. Si sale bien, recibes el mensaje o el registro. Si falla, recibes un error con un código y un mensaje breve.
Comprueba el indicador
Algunos errores, como campos incorrectos o falta de créditos, llegan dentro de una respuesta normal. Lee el indicador de éxito antes de fiarte del resultado.
Cuando la clave es incorrecta
Una clave ausente o no válida devuelve 401. Los campos que faltan o están mal formados devuelven 400.
Los endpoints de un vistazo
Todos en app.sms8.io. El archivo OpenAPI tiene los campos exactos de cada uno.
| Ruta | Método | Qué hace |
|---|---|---|
| /api/v1/messages | POST | Enviar un SMS o MMS a una persona o a un lote |
| /api/v1/messages/read | POST | Listar mensajes enviados y recibidos, filtrados por número, sentido o fecha |
| /api/v1/messages/resend | POST | Reintentar un mensaje fallido, por su ID |
| /api/v1/devices | GET | Listar los teléfonos vinculados con batería, cobertura, SIM y última conexión |
| /api/v1/contacts | POST | Crear o actualizar un contacto con etiquetas y campos personalizados |
| /api/v1/ussd/send | POST | Ejecutar un código USSD desde una SIM vinculada y obtener la respuesta del operador |
| /api/v1/ussd/list | POST | Listar tus sesiones USSD recientes |
Enviar un mensaje, campo a campo
Solo son obligatorios el número y el texto. Todo lo demás tiene un valor por defecto.
Número y texto
El número va en formato internacional, como +14155550100. El texto puede tener hasta 1.000 caracteres y usar etiquetas de combinación como {first_name}.
SMS o MMS
El tipo es sms por defecto. Para MMS, añade enlaces HTTPS públicos de imagen. SMS8 redimensiona cada imagen a 1.280 píxeles antes de enviarla.
Qué teléfono lo envía
Indica uno o varios ID de dispositivo y una ranura SIM, donde 0 es la SIM 1 y 1 es la SIM 2. Si no los pones, envía tu teléfono por defecto.
Rotación
Activa la opción para rotar entre todos tus teléfonos, o entre todas las SIM de todos los teléfonos. También es posible un teléfono al azar por mensaje.
Saltar la cola
Marca un mensaje como prioritario y pasa por delante de los demás en espera en ese teléfono. Útil para alertas y códigos.
Qué recibes
Un ID de mensaje para consultarlo después, el teléfono y la SIM que lo aceptaron y la hora en que entró en cola. Después el estado pasa por en cola, enviando, enviado, entregado o fallido.
Webhooks
Registra una URL y SMS8 le envía los eventos en cuanto ocurren. Cada webhook elige sus propios eventos y tiene su propio secreto de firma, para que puedas comprobar que cada petición viene de verdad de SMS8.
Recibido
Ha llegado una respuesta o un mensaje nuevo a uno de tus teléfonos. El que necesitan la mayoría de las configuraciones de CRM.
Enviado
Tu teléfono aceptó el mensaje y lo puso en cola en su SIM. Útil para registros de auditoría.
Entregado
El operador del destinatario confirmó la entrega.
Fallido
No se pudo enviar el mensaje tras varios reintentos, por ejemplo por un número erróneo o falta de cobertura.
Respuesta USSD
El operador respondió a un código USSD que enviaste.
Teléfono vinculado
Un teléfono nuevo se unió a tu cuenta.
Firmados, reintentados y registrados
Cada petición de webhook lleva una cabecera X-Signature. Es un hash HMAC-SHA256 del cuerpo bruto de la petición, hecho con el secreto propio de ese webhook, no con tu clave de API. Calcula el mismo hash en tu servidor, compara los dos con una comprobación de tiempo constante y descarta todo lo que no coincida.
Tu receptor debe usar HTTPS y debería responder con un estado 2xx en menos de 10 segundos. Si no lo hace, SMS8 vuelve a intentarlo con un calendario que va de unos minutos hasta 30 días. Cada intento aparece en el registro de entregas con el estado y la respuesta, y puedes reintentar cualquier fila a mano.
Responde primero y deja para después el trabajo lento, como consultas al CRM o una clasificación con IA. Usa el ID del mensaje como clave única para que un evento reintentado nunca se procese dos veces.
SDK y lenguajes
Cualquier lenguaje que pueda hacer una petición web funciona. Estos te ahorran la configuración.
Node y TypeScript
Instala sms8-sdk desde npm. Un solo paquete para el SDK, una herramienta de línea de comandos, utilidades para React y el puente MCP.
02PHP
Una clase PHP con un método para cada endpoint. Guarda el archivo, haz require y envía. Funciona en PHP 7.4 o posterior y solo necesita la extensión curl, así que encaja en Laravel, WordPress, Symfony o un script sencillo.
03C# y .NET
Una clase basada en HttpClient con métodos asíncronos. Funciona en .NET moderno, .NET Framework 4.6.2 o posterior, Unity, Xamarin y MAUI.
04Python y otros
La referencia muestra cada petición lista para copiar en tu lenguaje. El generador del panel te deja probar una petición con tu cuenta real.
Para agentes de IA
El servidor MCP de SMS8 en mcp.sms8.io permite a Claude, Cursor y otras herramientas de IA enviar SMS, enviar y comprobar códigos OTP, leer mensajes, listar tus teléfonos y crear webhooks.
Usa la misma clave de API, enviada como token bearer. Añádelo a tu herramienta de IA una vez y tu agente podrá enviar mensajes desde tu número.
Referencia completa
Todo, con los campos, respuestas y códigos de error exactos, está aquí.
Referencia de la API
Cada endpoint, campo y código de error, con un generador para probar peticiones con tu cuenta.
Abrir la referenciaArchivo OpenAPI
Importa la especificación en Postman, Insomnia o tu generador de código.
Descargar openapi.yamlAjustes de webhooks
Añade una URL de webhook, elige los eventos y consulta el registro de entregas.
Abrir webhooksEnvía tu clave de API con cada petición. La encontrarás en la página API de tu panel. El servidor MCP usa la misma clave como token bearer.
La API no tiene un límite artificial. Tus SIM marcan el ritmo real. Para envíos grandes, añade teléfonos o fija una pausa entre mensajes en tus ajustes.
Suscribe un webhook a los eventos entregado y fallido, o busca el mensaje por ID.
Sí. Pon el tipo en MMS y añade enlaces públicos de imagen. SMS8 redimensiona las imágenes antes de enviarlas.
Sí. Los endpoints actuales están en /api/v1, y las URL antiguas siguen funcionando para las apps existentes.
No. Cada webhook tiene su propio secreto de firma, que se fija al crearlo. Tu clave de API nunca sale de tus peticiones a SMS8.
Los eventos esperan en la cola de reintentos y SMS8 sigue intentándolo hasta 30 días. También puedes reenviar cualquier entrega desde el registro cuando vuelvas a estar en línea.
Sí. Importa el archivo OpenAPI en Postman, Insomnia o un generador de código para tener cada endpoint y cada campo.
Sí. Pasa un ID de dispositivo y una ranura SIM, o deja que SMS8 rote entre tus teléfonos y SIM para repartir la carga.
Haz tu primera llamada a la API
Crea una cuenta, vincula un teléfono y copia tu clave de API. Tu código puede enviar en minutos.