Execute workflow

Endpoint

POST https://embedworkflow.com/api/v1/workflows/{id}/execute

Path Parameters

id string, required

System-generated unique identifier

Request Body

id_type string, optionaldefault: id

Type of identifier used in the URL

user_key string, optionaldefault: main

User's key

execution_data object, optionaldefault: [object Object]

Data required to execute the workflow. Key-value pairs that provide context and variables needed during workflow execution.

Response

Returns created.

Response Properties

hashid string

System-generated unique identifier

actions_count integer

Total number of actions in the execution

completed_actions_count integer

Number of completed actions

created_at string

Created at in specified timezone

created_at_string string

Created at formatted as human-readable string

Errors

404 - not found

Response

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{
  "hashid": "g0og8",
  "actions_count": 0,
  "completed_actions_count": 0,
  "created_at": "2025-07-13T01:01:18-04:00",
  "created_at_string": "Jul 13, 2025 01:01 am EDT",
  "created_at_utc": "2025-07-13T05:01:18Z",
  "execution_data": {
    "user_name": "John Doe"
  },
  "failed_actions_count": 0,
  "id": "01980228-b13f-7e53-9081-589e75c77e46",
  "idle_actions_count": 0,
  "key": "workflow_15",
  "log": {},
  "name": "Workflow 15",
  "object": "execution",
  "running_actions_count": 0,
  "status": "running",
  "stopped_actions_count": 0
}