Skip to main content
POST
/
conversation-ai
/
agents
/
{agentId}
/
actions
Attach Action to Agent
curl --request POST \
  --url https://services.leadconnectorhq.com/conversation-ai/agents/{agentId}/actions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Version: <version>' \
  --data '
{
  "type": "triggerWorkflow",
  "name": "Trigger a Workflow",
  "details": {
    "workflowIds": [
      "workflow123",
      "workflow456"
    ],
    "triggerCondition": "When user requests appointment",
    "triggerMessage": "Workflow triggered successfully"
  }
}
'
{
  "data": {
    "id": "actionId123",
    "name": "Trigger Workflow",
    "type": "triggerWorkflow",
    "details": {
      "workflowIds": [
        "workflow123",
        "workflow456"
      ],
      "triggerCondition": "When user requests appointment",
      "triggerMessage": "Workflow triggered successfully"
    },
    "agentId": "agentId123"
  },
  "success": true
}

Authorizations

​
Authorization
string
header
required

Access Token or Private Integration Token

Headers

​
Version
enum<string>
required

API Version

Available options:
2021-04-15

Path Parameters

​
agentId
string
required

Body

application/json
​
type
enum<string>
required
Available options:
triggerWorkflow,
updateContactField,
appointmentBooking,
stopBot,
humanHandOver,
advancedFollowup,
transferBot
Example:

"triggerWorkflow"

​
name
string
required
Example:

"Trigger a Workflow"

​
details
object
required

Action-specific details. The structure depends on the action type. For TRIGGER_WORKFLOW use triggerWorkflowDto, for UPDATE_CONTACT_FIELD use updateContactFieldDto, for APPOINTMENT_BOOKING use appointmentBookingDto, for STOP_BOT use stopBotDto, for HUMAN_HAND_OVER use humanHandOverDto, for ADVANCED_FOLLOWUP use advancedFollowupDto, and for TRANSFER_BOT use transferBotDto.

Response

Successful response

​
data
object
required

Created action details

​
success
boolean
required

Success status of the request

Example:

true

Last modified on March 7, 2026