Tus SMS se envían desde tu propio móvil.Descubre cómo
PLATAFORMAArquitectura API-firstEmparejamiento seguro de dispositivoVisibilidad de entregaControl multi-dispositivoDocumentación versionada
Centro para desarrolladores/ Workflow Studio API

FLOW · 4 operaciones documentadas

Workflow Studio API documentation

List Workflow Studio automations, activate or pause them, manage mobile favorites and inspect execution logs from your own software.

Workflow Studio events, conditions and actions connected through the API
URL base RESThttps://api.smsmobileapi.com

Respuestas JSON · HTTPS requerido · UTF-8

Conecte su clave API

Conecte una vez y luego pruebe endpoints para SMS, llamadas, notificaciones, WhatsApp y correo.

Comienza aquí

Tu primera solicitud en cuatro pasos

1

Create at least one workflow in Workflow Studio from the dashboard or mobile app.

2

Call the list endpoint with your account API key and keep the public workflow_uuid.

3

Use the state or favorite endpoint to update that exact workflow.

4

Retrieve its execution logs to follow conditions, actions, errors and credit status.

ONE WORKFLOW, EVERY INTERFACE

Control the same automations everywhere.

Consignación de cuentas

The API reads and updates the exact workflows used by the dashboard, the SMSMobileAPI mobile app and the asynchronous Workflow Studio worker. A state or favorite change is therefore visible everywhere without copying a definition.

LIST

Discover workflows

Retrieve identifiers, triggers, schedules, conditions, actions and execution counters.

CONTROL

Activate or pause

Build safe operational switches while keeping every workflow definition intact.

FAVORITE

Manage mobile modes

Choose which workflows appear as quick controls on the mobile app home screen.

LOGS

Follow each execution

Inspect decisions, action attempts, errors, completion and credit consumption.

Autenticación

Mantén las credenciales en tu servidor

Send your account API key in the apikey parameter or as Authorization: Bearer YOUR_API_KEY. Every workflow lookup is scoped to that authenticated account. Keep the key on your server and never publish it in browser code, repositories, screenshots or public URLs.

Antes de integrar
  • State and favorite changes are immediately shared with the dashboard and SMSMobileAPI mobile app.
  • Internal MySQL row identifiers are never exposed. Use the public workflow_uuid for every workflow operation.
  • Pausing a workflow prevents it from matching future events. It does not cancel actions that were already queued.
  • All dates returned by these endpoints use UTC.
OBTENER

List Workflow Studio workflows

#
ENDPOINThttps://api.smsmobileapi.com/workflow/list/

Returns the workflows owned by the authenticated account, including their state, favorite flag, trigger, schedule, conditions, actions and execution counters.

Cuándo usarlo

Use it to build a workflow selector, synchronize another management interface or retrieve identifiers before calling another Workflow Studio endpoint.

Parámetros

NombreTipoRequisitoDescripción
apikey cadena Obligatorio Your account API key. You may instead use an Authorization: Bearer header.
page entero Opcional Page number. Default 1.
per_page entero Opcional Rows per page. Default 25, maximum 100.
search cadena Opcional Search the workflow name, description or UUID.
event_type cadena Opcional Return only workflows using this exact event, for example sms.received.
active boolean Opcional Use 1 or 0 to filter active or paused workflows.
favorite boolean Opcional Use 1 or 0 to filter mobile favorites.
include_definition boolean Opcional Default 1. Set to 0 to omit conditions, actions and schedule details.

Ejemplo de solicitud

rizo
curl "https://api.smsmobileapi.com/workflow/list/?apikey=YOUR_API_KEY&active=1&per_page=25"

Ejemplo de respuesta

JSON
{
  "success": true,
  "data": [
    {
      "workflow_uuid": "wf_0123456789abcdef0123456789abcdef",
      "name": "Reply after a missed call",
      "event_type": "call.missed",
      "active": true,
      "favorite": true,
      "conditions": [],
      "actions": [{"type":"send_sms","config":{"recipient":"{{data.number}}","message":"We will call you back shortly."}}],
      "run_count": 18,
      "success_count": 18,
      "failed_count": 0
    }
  ],
  "pagination": {"page":1,"per_page":25,"total":1,"pages":1,"has_more":false},
  "request_id": "wfreq_4d9b7d7b2b8b384b2ad6f237"
}

¿Quieres ejecutar esta solicitud?Conecte su clave API en la parte superior de la página para activar el probador interactivo.

Clave de conexión ↑
CORREO

Activate or pause a workflow

#
ENDPOINThttps://api.smsmobileapi.com/workflow/state/

Changes whether one account-owned workflow listens for future events.

Cuándo usarlo

Use it to expose a controlled on/off switch in your own application or activate operational modes from another system.

Parámetros

NombreTipoRequisitoDescripción
apikey cadena Obligatorio Your account API key. You may instead use an Authorization: Bearer header.
workflow_uuid cadena Obligatorio Public, stable workflow identifier returned by the list endpoint.
active boolean Obligatorio 1 activates the workflow; 0 pauses it.

Ejemplo de solicitud

rizo
curl -X POST "https://api.smsmobileapi.com/workflow/state/" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"workflow_uuid":"wf_0123456789abcdef0123456789abcdef","active":true}'

Ejemplo de respuesta

JSON
{
  "success": true,
  "message": "Workflow activated.",
  "workflow": {"workflow_uuid":"wf_0123456789abcdef0123456789abcdef","active":true,"favorite":true},
  "applies_to": "future_events",
  "request_id": "wfreq_250c732826cc1833e28cf1cc"
}

¿Quieres ejecutar esta solicitud?Conecte su clave API en la parte superior de la página para activar el probador interactivo.

Clave de conexión ↑
Bueno saber
  • This operation never changes the workflow definition.
  • Already queued actions are not cancelled when a workflow is paused.
CORREO

Add or remove a mobile favorite

#
ENDPOINThttps://api.smsmobileapi.com/workflow/favorite/

Controls whether a workflow is displayed among the favorites available from the SMSMobileAPI mobile app home screen.

Cuándo usarlo

Use it to create quick-access modes such as Driving, Work, Family or On-call.

Parámetros

NombreTipoRequisitoDescripción
apikey cadena Obligatorio Your account API key. You may instead use an Authorization: Bearer header.
workflow_uuid cadena Obligatorio Public, stable workflow identifier returned by the list endpoint.
favorite boolean Obligatorio 1 adds the workflow to favorites; 0 removes it.

Ejemplo de solicitud

rizo
curl -X POST "https://api.smsmobileapi.com/workflow/favorite/" \
  -d "apikey=YOUR_API_KEY" \
  -d "workflow_uuid=wf_0123456789abcdef0123456789abcdef" \
  -d "favorite=1"

Ejemplo de respuesta

JSON
{
  "success": true,
  "message": "Workflow added to mobile favorites.",
  "workflow": {"workflow_uuid":"wf_0123456789abcdef0123456789abcdef","active":true,"favorite":true},
  "request_id": "wfreq_a9175f9b864aab7b998325b7"
}

¿Quieres ejecutar esta solicitud?Conecte su clave API en la parte superior de la página para activar el probador interactivo.

Clave de conexión ↑
OBTENER

List one workflow’s execution logs

#
ENDPOINThttps://api.smsmobileapi.com/workflow/logs/

Returns paginated runs for one workflow with the event, status, condition trace, action attempts, errors and billing state.

Cuándo usarlo

Use it to display recent activity, diagnose a failed action or confirm that a workflow matched the expected event.

Parámetros

NombreTipoRequisitoDescripción
apikey cadena Obligatorio Your account API key. You may instead use an Authorization: Bearer header.
workflow_uuid cadena Obligatorio Public, stable workflow identifier returned by the list endpoint.
status cadena Opcional Filter by matched, skipped, queued, running, completed, failed, cancelled, credit_required or test.
page entero Opcional Page number. Default 1.
per_page entero Opcional Rows per page. Default 25, maximum 100.
include_details boolean Opcional Default 1. Set to 0 to omit input and condition trace details.

Ejemplo de solicitud

rizo
curl "https://api.smsmobileapi.com/workflow/logs/?apikey=YOUR_API_KEY&workflow_uuid=wf_0123456789abcdef0123456789abcdef&status=completed&per_page=25"

Ejemplo de respuesta

JSON
{
  "success": true,
  "workflow": {"workflow_uuid":"wf_0123456789abcdef0123456789abcdef","name":"Reply after a missed call","event_type":"call.missed","active":true},
  "data": [
    {
      "event_uuid": "evt_01J8EXAMPLE9Q4V",
      "event_type": "call.missed",
      "status": "completed",
      "test_mode": false,
      "credit_status": "consumed",
      "created_at": "2026-10-06 08:14:21",
      "finished_at": "2026-10-06 08:14:22",
      "actions": [{"action_index":0,"action_type":"send_sms","status":"completed","attempts":1}]
    }
  ],
  "pagination": {"page":1,"per_page":25,"total":1,"pages":1,"has_more":false},
  "request_id": "wfreq_0a53eab7bef30e5ba52a0f86"
}

¿Quieres ejecutar esta solicitud?Conecte su clave API en la parte superior de la página para activar el probador interactivo.

Clave de conexión ↑
Bueno saber
  • A completed run represents a successfully finalized workflow execution.
  • The request_id can be included in a support request without revealing the API key.

Solución de problemas

Errores y reintentos seguros

Consulta el estado de HTTP y el campo de error JSON antes de reintentar. No vuelvas a intentar validaciones o fallos de autenticación sin corregir primero la petición.

HTTPCódigoQué hacer
400missing_apikeyNo apikey parameter or Bearer token was supplied.
401invalid_apikeyThe API key is unknown or disabled.
404workflow_not_foundThe workflow does not exist or does not belong to the authenticated account.
422invalid_parameterA state, favorite, identifier, status or filter value is invalid.
423confidential_mode_activeStandard API access is locked while Confidential Mode is active.
503service_unavailableWorkflow Studio storage or account validation is temporarily unavailable.
Regla de reintentoReintente sólo respuestas transitorias 429 y 5xx. Comience tras 1 segundo, luego espere 2, 4 y 8 segundos.

¿Necesitas ayuda?

Trae el contexto de la solicitud, no tus secretos.

Comparte el endpoint, la marca de tiempo, el estado HTTP y la respuesta saneada. Nunca incluyas claves API, tokens ni contenido privado de mensajes.

Contactar soporte API →
La aplicación móvil segura SMSMobileAPI que conecta un teléfono con el panel web y REST API para operaciones de SMS y llamadas.
Conexión cifrada móvil a plataforma

Aplicación móvil oficial

El puente seguro entre tu teléfono, el panel y API.

Las operaciones de SMS y llamadas se realizan a través de la aplicación oficial SMSMobileAPI instalada en tu teléfono conectado. La app vincula el dispositivo de forma segura con tu cuenta, sincroniza eventos autorizados y conecta la red móvil con el panel de control y REST API.

1Aplicación móvilEmpareja el teléfono y su SIM 2Enlace cifradoAutentica y protege los datos en tránsito 3Panel de control y APIControla flujos de trabajo y actividad
  • Lanzamientos firmados distribuidos a través de las listas oficiales Google Play y Apple App Store
  • Controles de revisión, firma y distribución de plataformas Google y Apple
  • Emparejamiento seguro de dispositivo, transporte HTTPS y acceso autenticado API
  • Solo los permisos requeridos para las funciones móviles que habilites
Descarga la app oficial SMSMobileAPI en Google Play Descarga la app oficial SMSMobileAPI en la Apple App Store
Las capacidades dependen de los permisos y el acceso en segundo plano permitidos por Android o iOS.