Sign in

v1

latestOpenAPI 3.0.0Proprietary2026-08-062711471.0 MB
Workflows

Create workflow node

Creates a node in an automation workflow graph. The server assigns nodeId and alias; use the 201 response when adding edges or updates.

post/public/v1/workflows/{workflowId}/nodes

Path parameters

workflowIdnumber nullable
Example:42

Request body

Example request

{
  "node": {
    "name": "Initial trigger",
    "position": {
      "positionX": 1,
      "positionY": 1
    },
    "type": "TRIGGER",
    "data": {
      "type": "TRIGGER",
      "triggerType": "CONVERSATION_ENDED",
      "triggeredBy": "BOTH",
      "triggeredByAgentIds": [
        "example"
      ],
      "triggerByWebhookIds": [
        "example"
      ],
      "triggeredByTableId": 1,
      "triggeredByRecordTypeId": 1,
      "connectedAccountTriggerId": "example",
      "triggerToolkit": "example",
      "triggerSlug": "example",
      "connectedAccountId": 1
    }
  }
}

Response

Created node

nodeIdstring required
aliasstring nullable required
namestring
type'TRIGGER' | 'SCHEDULED_TRIGGER' | 'WEBHOOK' | 'TOOLS_AI' | 'API' | 'CONDITIONAL_ROUTING' | 'AI_CAPTURE' | 'DATA_TRANSFORMER' | 'DYNAMIC_TABLES' | 'ITERATION' | 'BREAK' | 'AUTOMATION_STATUS' | 'SEND_MESSAGE' | 'SEND_WHATSAPP_MESSAGE' | 'TRANSCRIPTION' | 'FILE_ANALYSIS' | 'CREATE_RECORD_ACTIVITY' required
workflowIdstring
createdAtstring nullable
updatedAtstring nullable

Example response

{
  "nodeId": "node_550e8400-e29b-41d4-a716-446655440000",
  "alias": "API Call",
  "name": "Initial trigger",
  "position": {
    "positionX": 1,
    "positionY": 1
  },
  "type": "TRIGGER",
  "data": {
    "type": "TRIGGER",
    "triggerType": "CONVERSATION_ENDED",
    "triggeredBy": "BOTH",
    "triggeredByAgentIds": [
      "example"
    ],
    "triggerByWebhookIds": [
      "example"
    ],
    "triggeredByTableId": 1,
    "triggeredByRecordTypeId": 1,
    "connectedAccountTriggerId": "example",
    "triggerToolkit": "example",
    "triggerSlug": "example",
    "connectedAccountId": 1
  },
  "workflowId": "example",
  "handles": [
    {
      "handleId": "example",
      "sourceEdge": {
        "from": "example",
        "fromHandleId": "example",
        "to": "example",
        "toHandleId": "example"
      },
      "text": "example"
    }
  ],
  "targetEdges": [
    {
      "from": "example",
      "fromHandleId": "example",
      "to": "example",
      "toHandleId": "example"
    }
  ],
  "createdAt": "example",
  "updatedAt": "example"
}