Start her
Din første anmodning i fire trin
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.
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.
LISTDiscover workflows
Retrieve identifiers, triggers, schedules, conditions, actions and execution counters.
CONTROLActivate or pause
Build safe operational switches while keeping every workflow definition intact.
FAVORITEManage mobile modes
Choose which workflows appear as quick controls on the mobile app home screen.
LOGSFollow each execution
Inspect decisions, action attempts, errors, completion and credit consumption.
Autentificering
Behold legitimation på din 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.
- 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.
FÅ
List Workflow Studio workflows
https://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.
Use it to build a workflow selector, synchronize another management interface or retrieve identifiers before calling another Workflow Studio endpoint.
Parametre
| Navn | Type | Krav | Beskrivelse |
|---|---|---|---|
apikey |
snor | Påkrævet | Your account API key. You may instead use an Authorization: Bearer header. |
page |
heltal | Valgfrit | Page number. Default 1. |
per_page |
heltal | Valgfrit | Rows per page. Default 25, maximum 100. |
search |
snor | Valgfrit | Search the workflow name, description or UUID. |
event_type |
snor | Valgfrit | Return only workflows using this exact event, for example sms.received. |
active |
boolean | Valgfrit | Use 1 or 0 to filter active or paused workflows. |
favorite |
boolean | Valgfrit | Use 1 or 0 to filter mobile favorites. |
include_definition |
boolean | Valgfrit | Default 1. Set to 0 to omit conditions, actions and schedule details. |
Eksempel på anmodning
curl "https://api.smsmobileapi.com/workflow/list/?apikey=YOUR_API_KEY&active=1&per_page=25"
Eksempel på svar
{
"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"
}
Vil du køre denne anmodning?Tilslut din API nøgle øverst på siden for at låse den interaktive tester op.
Forbind nøgle ↑
STOLPE
Activate or pause a workflow
https://api.smsmobileapi.com/workflow/state/Changes whether one account-owned workflow listens for future events.
Use it to expose a controlled on/off switch in your own application or activate operational modes from another system.
Parametre
| Navn | Type | Krav | Beskrivelse |
|---|---|---|---|
apikey |
snor | Påkrævet | Your account API key. You may instead use an Authorization: Bearer header. |
workflow_uuid |
snor | Påkrævet | Public, stable workflow identifier returned by the list endpoint. |
active |
boolean | Påkrævet | 1 activates the workflow; 0 pauses it. |
Eksempel på anmodning
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}'
Eksempel på svar
{
"success": true,
"message": "Workflow activated.",
"workflow": {"workflow_uuid":"wf_0123456789abcdef0123456789abcdef","active":true,"favorite":true},
"applies_to": "future_events",
"request_id": "wfreq_250c732826cc1833e28cf1cc"
}
Vil du køre denne anmodning?Tilslut din API nøgle øverst på siden for at låse den interaktive tester op.
Forbind nøgle ↑- This operation never changes the workflow definition.
- Already queued actions are not cancelled when a workflow is paused.
STOLPE
Add or remove a mobile favorite
https://api.smsmobileapi.com/workflow/favorite/Controls whether a workflow is displayed among the favorites available from the SMSMobileAPI mobile app home screen.
Use it to create quick-access modes such as Driving, Work, Family or On-call.
Parametre
| Navn | Type | Krav | Beskrivelse |
|---|---|---|---|
apikey |
snor | Påkrævet | Your account API key. You may instead use an Authorization: Bearer header. |
workflow_uuid |
snor | Påkrævet | Public, stable workflow identifier returned by the list endpoint. |
favorite |
boolean | Påkrævet | 1 adds the workflow to favorites; 0 removes it. |
Eksempel på anmodning
curl -X POST "https://api.smsmobileapi.com/workflow/favorite/" \
-d "apikey=YOUR_API_KEY" \
-d "workflow_uuid=wf_0123456789abcdef0123456789abcdef" \
-d "favorite=1"
Eksempel på svar
{
"success": true,
"message": "Workflow added to mobile favorites.",
"workflow": {"workflow_uuid":"wf_0123456789abcdef0123456789abcdef","active":true,"favorite":true},
"request_id": "wfreq_a9175f9b864aab7b998325b7"
}
Vil du køre denne anmodning?Tilslut din API nøgle øverst på siden for at låse den interaktive tester op.
Forbind nøgle ↑
FÅ
List one workflow’s execution logs
https://api.smsmobileapi.com/workflow/logs/Returns paginated runs for one workflow with the event, status, condition trace, action attempts, errors and billing state.
Use it to display recent activity, diagnose a failed action or confirm that a workflow matched the expected event.
Parametre
| Navn | Type | Krav | Beskrivelse |
|---|---|---|---|
apikey |
snor | Påkrævet | Your account API key. You may instead use an Authorization: Bearer header. |
workflow_uuid |
snor | Påkrævet | Public, stable workflow identifier returned by the list endpoint. |
status |
snor | Valgfrit | Filter by matched, skipped, queued, running, completed, failed, cancelled, credit_required or test. |
page |
heltal | Valgfrit | Page number. Default 1. |
per_page |
heltal | Valgfrit | Rows per page. Default 25, maximum 100. |
include_details |
boolean | Valgfrit | Default 1. Set to 0 to omit input and condition trace details. |
Eksempel på anmodning
curl "https://api.smsmobileapi.com/workflow/logs/?apikey=YOUR_API_KEY&workflow_uuid=wf_0123456789abcdef0123456789abcdef&status=completed&per_page=25"
Eksempel på svar
{
"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"
}
Vil du køre denne anmodning?Tilslut din API nøgle øverst på siden for at låse den interaktive tester op.
Forbind nøgle ↑- A completed run represents a successfully finalized workflow execution.
- The request_id can be included in a support request without revealing the API key.
Fejlfinding
Fejl og sikre forsøg på at vende tilbage
Læs HTTP status og JSON fejlfeltet før genforsøg. Fortryd ikke validerings- eller autentificeringsfejl uden først at korrigere anmodningen.
| HTTP | Kode | Hvad skal man gøre? |
|---|---|---|
| 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. |
Brug for hjælp?
Medbring forespørgslen kontekst - ikke dine hemmeligheder.
Del endepunkt, tidsstempel, HTTP status og renset respons. Aldrig inkludere API nøgler, tokens eller privat besked indhold.
Officiel mobilapplikation
Den sikre bro mellem telefonen, instrumentbrættet og API.
SMS og opkald operationer passere gennem den officielle SMSMobileAPI app installeret på din tilsluttede telefon. App sikkert parrer enheden med din konto, synkroniserer godkendte begivenheder og forbinder mobilnetværket til instrumentbrættet og REST API.
- Signerede udgivelser distribueret gennem de officielle Google Play og Apple App Store lister
- Google og Apple platform gennemgang, signaturer og distribution kontrol
- Sikker parring af enheden, HTTPS transport og autentificeret API adgang
- Kun de tilladelser, der kræves for de mobile funktioner, du aktiverer


