Skip to main content
POST
/
flows
/
trigger
/
{flowId}
JavaScript
const response = await fetch(
  'https://api.worqhat.com/flows/trigger/f825ab82-371f-40cb-9bed-b325531ead4a',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      key1: 'value1',
      key2: 'value2'
    })
  }
);
const data = await response.json();
{
  "success": true,
  "message": "Workflow f825ab82-371f-40cb-9bed-b325531ead4a triggered successfully",
  "analytics_id": "1f9152dc-dec8-496f-8ba4-ed1c27a72684",
  "timestamp": "2025-07-26T03:28:08.123Z",
  "data": {
    "workflow_status": "started",
    "additional_data": "from backend response"
  }
}

Authorizations

​
Authorization
string
header
required

API key authentication. Format - "Bearer YOUR_API_KEY"

Path Parameters

​
flowId
string
required

ID of the workflow to trigger

Example:

"f825ab82-371f-40cb-9bed-b325531ead4a"

Body

application/json

JSON payload to send to the workflow

Request payload to trigger a workflow

​
data
object

Optional structured data to pass to the workflow

Response

Workflow triggered successfully

​
success
boolean
Example:

true

​
message
string
Example:

"Workflow f825ab82-371f-40cb-9bed-b325531ead4a triggered successfully"

​
analytics_id
string<uuid>
Example:

"1f9152dc-dec8-496f-8ba4-ed1c27a72684"

​
timestamp
string<date-time>
Example:

"2025-07-26T03:28:08.123Z"

​
data
object
Example:
{
  "workflow_status": "started",
  "additional_data": "from backend response"
}