Inizia qui

La vostra prima richiesta in quattro passi

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

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

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

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

ONE WORKFLOW, EVERY INTERFACE

Control the same automations everywhere.

Conto in corso

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.

Autenticazione

Mantenere le credenziali sul server

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.

Prima di integrare

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.

OTTENERE

List Workflow Studio workflows

FINEhttps://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.

Quando usarlo

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

Parametri

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

Esempio di richiesta

CURL

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

Esempio di risposta

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

Vuoi eseguire questa richiesta?Collegare il tasto API nella parte superiore della pagina per sbloccare il tester interattivo.

Collegare la chiave

INVIARE

Activate or pause a workflow

FINEhttps://api.smsmobileapi.com/workflow/state/

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

Quando usarlo

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

Parametri

Nome	Tipo	Requisito	Descrizione
`apikey`	corda	Necessario	Your account API key. You may instead use an Authorization: Bearer header.
`workflow_uuid`	corda	Necessario	Public, stable workflow identifier returned by the list endpoint.
`active`	boolean	Necessario	1 activates the workflow; 0 pauses it.

Esempio di richiesta

CURL

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

Esempio di risposta

JSON

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

Vuoi eseguire questa richiesta?Collegare il tasto API nella parte superiore della pagina per sbloccare il tester interattivo.

Collegare la chiave

Buono a sapersi

This operation never changes the workflow definition.
Already queued actions are not cancelled when a workflow is paused.

INVIARE

Add or remove a mobile favorite

FINEhttps://api.smsmobileapi.com/workflow/favorite/

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

Quando usarlo

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

Parametri

Nome	Tipo	Requisito	Descrizione
`apikey`	corda	Necessario	Your account API key. You may instead use an Authorization: Bearer header.
`workflow_uuid`	corda	Necessario	Public, stable workflow identifier returned by the list endpoint.
`favorite`	boolean	Necessario	1 adds the workflow to favorites; 0 removes it.

Esempio di richiesta

CURL

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

Esempio di risposta

JSON

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

Vuoi eseguire questa richiesta?Collegare il tasto API nella parte superiore della pagina per sbloccare il tester interattivo.

Collegare la chiave

OTTENERE

List one workflow’s execution logs

FINEhttps://api.smsmobileapi.com/workflow/logs/

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

Quando usarlo

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

Parametri

Nome	Tipo	Requisito	Descrizione
`apikey`	corda	Necessario	Your account API key. You may instead use an Authorization: Bearer header.
`workflow_uuid`	corda	Necessario	Public, stable workflow identifier returned by the list endpoint.
`status`	corda	Facoltativo	Filter by matched, skipped, queued, running, completed, failed, cancelled, credit_required or test.
`page`	Integer	Facoltativo	Page number. Default 1.
`per_page`	Integer	Facoltativo	Rows per page. Default 25, maximum 100.
`include_details`	boolean	Facoltativo	Default 1. Set to 0 to omit input and condition trace details.

Esempio di richiesta

CURL

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

Esempio di risposta

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

Vuoi eseguire questa richiesta?Collegare il tasto API nella parte superiore della pagina per sbloccare il tester interattivo.

Collegare la chiave

Buono a sapersi

A completed run represents a successfully finalized workflow execution.
The request_id can be included in a support request without revealing the API key.

Risoluzione dei problemi

Errori e ritiri sicuri

Leggi lo stato HTTP e il campo di errore JSON prima di riprovare. Non riprovare i guasti di convalida o di autenticazione senza correggere prima la richiesta.

HTTP	Codice	Cosa fare
400	`missing_apikey`	No apikey parameter or Bearer token was supplied.
401	`invalid_apikey`	The API key is unknown or disabled.
404	`workflow_not_found`	The workflow does not exist or does not belong to the authenticated account.
422	`invalid_parameter`	A state, favorite, identifier, status or filter value is invalid.
423	`confidential_mode_active`	Standard API access is locked while Confidential Mode is active.
503	`service_unavailable`	Workflow Studio storage or account validation is temporarily unavailable.

Regola di riprovaRecuperare solo risposte transitorie 429 e 5xxx. Inizia dopo 1 secondo, poi torna a 2, 4 e 8 secondi.

Hai bisogno di aiuto?

Portare il contesto della richiesta, non i tuoi segreti.

Condividi il punto finale, timestamp, stato HTTP e risposta igienica. Non includere mai chiavi API, gettoni o contenuti di messaggi privati.

Contatto API supporto →

L'app mobile SMSMobileAPI sicura che collega un telefono al cruscotto web e REST API per operazioni SMS e chiamate — Connessione crittografata mobile-to-piattaforma

Applicazione mobile ufficiale

Il ponte sicuro tra il telefono, il cruscotto e API.

Le operazioni SMS e di chiamata passano attraverso l'app ufficiale SMSMobileAPI installata sul telefono connesso. L'applicazione si abbina in modo sicuro al dispositivo con il tuo account, sincronizza eventi autorizzati e collega la rete mobile al cruscotto e REST API.

1App mobileCoppia il telefono e la sua SIM 2Link crittografatoAutentichezza e protegge i dati in transito 3Dashboard & APIControlli flussi di lavoro e attività

Comunicati firmati distribuiti attraverso gli elenchi ufficiali di Google Play e Apple App Store
Controllo di Google e Apple piattaforma, controllo di firma e distribuzione
Accoppiamento sicuro del dispositivo, trasporto HTTPS e accesso autenticato API
Solo le autorizzazioni richieste per le funzionalità mobili che abilitate

Ottenere l'applicazione ufficiale SMSMobileAPI su Google Play

Scarica l'app ufficiale SMSMobileAPI sull'App Store Apple

Le capacità dipendono dalle autorizzazioni e dall'accesso di sfondo consentito da Android o iOS.

Workflow Studio API documentation

La vostra prima richiesta in quattro passi

Discover workflows

Activate or pause

Manage mobile modes

Follow each execution

Mantenere le credenziali sul server

Parametri

Esempio di richiesta

Esempio di risposta

Parametri

Esempio di richiesta

Esempio di risposta

Parametri

Esempio di richiesta

Esempio di risposta

Parametri

Esempio di richiesta

Esempio di risposta

Errori e ritiri sicuri

Portare il contesto della richiesta, non i tuoi segreti.

Il ponte sicuro tra il telefono, il cruscotto e API.