.svg?fit=max&auto=format&n=fnPhXvYfm-TNmZho&q=85&s=dc407af2e287b4714cedea5b8d7abf4d){kind=logo}
MCP tool: create_workflow
Creates a new workflow with comprehensive definition and configuration. This tool allows you to define workflow steps, activities, triggers, and execution policies.
Example prompt
Create a workflow for ticket escalation with notification and assignment steps
Input parameters
| Name | Type | Required | Description |
|---|---|---|---|
| name | string | Yes | The name of the workflow |
| teamId | string | Yes | The team ID that owns this workflow |
| type | string | Yes | The type of the workflow |
| subType | string | No | The sub-type of the workflow |
| triggerEvent | object | Yes | The event that triggers this workflow |
| filters | object | No | Filters to apply to the workflow trigger |
| annotations | array | No | Annotations for the workflow |
| workflowDefinition | array | Yes | The definition of workflow steps |
| executingAgent | string | No | The agent that executes this workflow |
| isActive | boolean | No | Whether the workflow is active (default: true) |
| metadata | object | No | Additional metadata for the workflow |
Trigger event structure
| Field | Type | Required | Description |
|---|---|---|---|
| uid | string | Yes | The unique identifier of the trigger event |
| eventName | string | Yes | The name of the trigger event |
Workflow step structure
Each step in theworkflowDefinition array contains:
| Field | Type | Required | Description |
|---|---|---|---|
| stepIdentifier | number | Yes | The identifier for this step |
| activity | object | Yes | The activity to execute in this step |
| input | object | Yes | The input parameters for this activity |
| retryPolicy | object | No | The retry policy for this step |
| onFailure | string | No | Action to take on failure (CONTINUE, ABORT, COMPENSATE) |
| isSleepActivity | boolean | No | Whether this is a sleep/wait activity |
| executionTimeout | number | No | Timeout for execution in seconds |
| approver | object | No | Approver configuration for this step |
| dependencies | array | No | Step dependencies |
| filters | object | No | Filters for this step |
Activity structure
| Field | Type | Required | Description |
|---|---|---|---|
| uniqueIdentifier | string | Yes | The unique identifier of the activity |
| version | number | No | The version of the activity |
| autoUpgradeToLatestVersion | boolean | No | Whether to automatically upgrade to the latest version (default: true) |
Retry policy structure
| Field | Type | Required | Description |
|---|---|---|---|
| maximumAttempts | number | No | Maximum number of retry attempts |
| initialInterval | number | No | Initial interval between retries in seconds |
| backoffCoefficient | number | No | Backoff coefficient for retry intervals |
Approver structure
| Field | Type | Required | Description |
|---|---|---|---|
| type | string | No | Type of approver (TEAM or USER) |
| uid | string | No | ID of the approver |
| timeout | number | No | Timeout for approval in seconds |
Response fields
The response will contain the created workflow with the same structure as theget_workflow tool.
Sample response
{
"data": {
"uid": "WORKFLOW001",
"type": "WORKFLOW",
"subType": "AI_AGENT",
"uniqueIdentifier": "ticket-escalation-workflow",
"name": "Ticket Escalation Workflow",
"version": 1,
"triggerEvent": {
"id": "EVENT001",
"name": "ticket.created",
"description": "Triggered when a new ticket is created"
},
"filters": {
"priority": "high",
"team": "support"
},
"annotations": [
{
"entityType": "workflow",
"data": {
"tags": ["escalation", "automation"]
},
"relations": []
}
],
"workflowDefinition": [
{
"stepIdentifier": 1,
"activity": {
"name": "send-notification",
"uniqueIdentifier": "notification.activity",
"version": 1,
"autoUpgradeToLatestVersion": true
},
"input": {
"recipients": ["support-team"],
"message": "High priority ticket requires immediate attention",
"priority": "urgent"
},
"retryPolicy": {
"maximumAttempts": 3,
"initialInterval": 1000,
"backoffCoefficient": 2
},
"onFailure": "CONTINUE",
"isSleepActivity": false,
"executionTimeout": 30000,
"dependencies": [],
"filters": {
"notificationType": "escalation"
}
},
{
"stepIdentifier": 2,
"activity": {
"name": "assign-to-senior-agent",
"uniqueIdentifier": "assignment.activity",
"version": 1,
"autoUpgradeToLatestVersion": true
},
"input": {
"priority": "high",
"skillSet": ["escalation", "technical"],
"autoAssign": true
},
"retryPolicy": {
"maximumAttempts": 2,
"initialInterval": 5000,
"backoffCoefficient": 1.5
},
"onFailure": "ABORT",
"isSleepActivity": false,
"executionTimeout": 60000,
"dependencies": [1],
"filters": {
"agentLevel": "senior"
}
}
],
"executingAgent": "workflow-engine",
"isActive": true,
"createdAt": "2025-07-24T07:19:10.258Z",
"updatedAt": "2025-07-24T07:19:10.258Z",
"createdBy": "USER001",
"teamId": "TEAM001",
"metadata": {
"description": "Automated workflow for escalating high-priority tickets",
"tags": ["escalation", "automation", "support"],
"category": "customer-service"
}
},
"status": true,
"message": "Workflow created successfully!",
"timestamp": "2025-07-25T12:50:38.937Z"
}