Hier beginnen

Ihre erste Anfrage in vier Schritten

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.

Kontoumfang

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.

Authentifizierung

Bewahren Sie Ihre Anmeldeinformationen auf Ihrem Server auf

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.

Bevor Sie integrieren

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.

ERHALTEN

List Workflow Studio workflows

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

Wann man es benutzt

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

Parameter

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

Anfordern Beispiel

CURL

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

Beispielantwort

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

Möchten Sie diese Anfrage ausführen?Verbinden Sie Ihren API-Schlüssel oben auf der Seite, um den interaktiven Tester zu entsperren.

Schlüssel verbinden ↑

STRASSE

Activate or pause a workflow

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

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

Wann man es benutzt

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

Parameter

Name	Typ	Anforderungen	Beschreibung
`apikey`	Zeichenkette	Erforderlich	Your account API key. You may instead use an Authorization: Bearer header.
`workflow_uuid`	Zeichenkette	Erforderlich	Public, stable workflow identifier returned by the list endpoint.
`active`	boolean	Erforderlich	1 activates the workflow; 0 pauses it.

Anfordern Beispiel

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

Beispielantwort

JSON

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

Möchten Sie diese Anfrage ausführen?Verbinden Sie Ihren API-Schlüssel oben auf der Seite, um den interaktiven Tester zu entsperren.

Schlüssel verbinden ↑

Gut zu wissen

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

STRASSE

Add or remove a mobile favorite

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

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

Wann man es benutzt

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

Parameter

Name	Typ	Anforderungen	Beschreibung
`apikey`	Zeichenkette	Erforderlich	Your account API key. You may instead use an Authorization: Bearer header.
`workflow_uuid`	Zeichenkette	Erforderlich	Public, stable workflow identifier returned by the list endpoint.
`favorite`	boolean	Erforderlich	1 adds the workflow to favorites; 0 removes it.

Anfordern Beispiel

CURL

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

Beispielantwort

JSON

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

Möchten Sie diese Anfrage ausführen?Verbinden Sie Ihren API-Schlüssel oben auf der Seite, um den interaktiven Tester zu entsperren.

Schlüssel verbinden ↑

ERHALTEN

List one workflow’s execution logs

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

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

Wann man es benutzt

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

Parameter

Name	Typ	Anforderungen	Beschreibung
`apikey`	Zeichenkette	Erforderlich	Your account API key. You may instead use an Authorization: Bearer header.
`workflow_uuid`	Zeichenkette	Erforderlich	Public, stable workflow identifier returned by the list endpoint.
`status`	Zeichenkette	Fakultativ	Filter by matched, skipped, queued, running, completed, failed, cancelled, credit_required or test.
`page`	Ganzzahl	Fakultativ	Page number. Default 1.
`per_page`	Ganzzahl	Fakultativ	Rows per page. Default 25, maximum 100.
`include_details`	boolean	Fakultativ	Default 1. Set to 0 to omit input and condition trace details.

Anfordern Beispiel

CURL

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

Beispielantwort

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

Möchten Sie diese Anfrage ausführen?Verbinden Sie Ihren API-Schlüssel oben auf der Seite, um den interaktiven Tester zu entsperren.

Schlüssel verbinden ↑

Gut zu wissen

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

Fehlerbehebung

Fehler und sichere Versuche

Lesen Sie den HTTP-Status und das JSON-Fehlerfeld, bevor Sie es erneut versuchen. Versuchen Sie keine Validierungs- oder Authentifizierungsfehler erneut, ohne die Anforderung zuerst zu korrigieren.

HTTP	Code	Was zu tun ist
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.

Retro-RegelReproduzieren Sie nur vorübergehende 429 und 5xx Antworten. Beginnen Sie nach 1 Sekunde, dann wieder auf 2, 4 und 8 Sekunden.

Brauchen Sie Hilfe?

Bringen Sie den Anfragekontext mit - nicht Ihre Geheimnisse.

Teilen Sie den Endpunkt, den Zeitstempel, den HTTP-Status und die desinfizierte Antwort. Fügen Sie niemals API-Schlüssel, Token oder private Nachrichteninhalte hinzu.

Kontakt API Unterstützung

Die sichere mobile App SMSMobileAPI, die ein Telefon mit dem Web-Dashboard und REST API für SMS- und Anrufvorgänge verbindet — Verschlüsselte Mobile-to-Plattform-Verbindung

Offizielle mobile Anwendung

Die sichere Brücke zwischen Ihrem Telefon, Dashboard und API.

SMS- und Anrufvorgänge werden über die offizielle SMSMobileAPI-App abgewickelt, die auf Ihrem angeschlossenen Telefon installiert ist. Die App koppelt das Gerät sicher mit Ihrem Konto, synchronisiert autorisierte Ereignisse und verbindet das Mobilfunknetz mit dem Dashboard und REST API.

1Mobile App AppPairs das Telefon und seine SIM 2Verschlüsselte VerbindungAuthentifizierung und Schutz von Daten im Transit 3Dashboard & APISteuerung von Workflows und Aktivitäten

Signierte Releases, die über die offiziellen Google Play- und Apple App Store-Listen verteilt werden
Google und Apple Plattform Überprüfung, Signierung und Verteilungskontrollen
Sichere Gerätepaarung, HTTPS-Transport und authentifizierter API-Zugang
Nur die Berechtigungen, die für die von Ihnen aktivierten mobilen Funktionen erforderlich sind

Holen Sie sich die offizielle SMSMobileAPI App auf Google Play

Laden Sie die offizielle SMSMobileAPI App im Apple App Store herunter

Die Fähigkeiten hängen von den Berechtigungen und dem Hintergrundzugriff ab, die von Android oder iOS erlaubt werden.

Workflow Studio API documentation

Ihre erste Anfrage in vier Schritten

Discover workflows

Activate or pause

Manage mobile modes

Follow each execution

Bewahren Sie Ihre Anmeldeinformationen auf Ihrem Server auf

Parameter

Anfordern Beispiel

Beispielantwort

Parameter

Anfordern Beispiel

Beispielantwort

Parameter

Anfordern Beispiel

Beispielantwort

Parameter

Anfordern Beispiel

Beispielantwort

Fehler und sichere Versuche

Bringen Sie den Anfragekontext mit - nicht Ihre Geheimnisse.

Die sichere Brücke zwischen Ihrem Telefon, Dashboard und API.