ActionsVersion: v3
Create Agent Action
POST/voice-ai/actions
Create a new action for a voice AI agent. Actions define specific behaviors and capabilities for the agent during calls.
Authorizations
Authorizationstringheaderrequired
Bearer authentication header of the form Bearer <token>, where <token> is your access token.
Scope:
voice-ai-agent-goals.Auth methods:
OAuthPrivate IntegrationToken type:
Sub-Account TokenRequest
Headers
Versionstringrequired
API Version
Available options
v3Body
agentIdstringrequired
Agent ID to attach the action to
Example:
507f1f77bcf86cd799439011locationIdstringrequired
Location ID
Example:
507f1f77bcf86cd799439012actionTypestringrequired
Type of action
Available options
CALL_TRANSFERDATA_EXTRACTIONIN_CALL_DATA_EXTRACTIONWORKFLOW_TRIGGERSMSAPPOINTMENT_BOOKINGCUSTOM_ACTIONKNOWLEDGE_BASEExample:
CALL_TRANSFERnamestringrequired
Human-readable name for this action
Example:
Transfer to ManageractionParametersobjectrequired
Action parameters - structure varies by actionType
Response
Action created successfully
idstringrequired
Unique identifier for the created action
Example:
507f1f77bcf86cd799439011actionTypestringrequired
Type of action
Available options
CALL_TRANSFERDATA_EXTRACTIONIN_CALL_DATA_EXTRACTIONWORKFLOW_TRIGGERSMSAPPOINTMENT_BOOKINGCUSTOM_ACTIONKNOWLEDGE_BASEExample:
CALL_TRANSFERnamestringrequired
Human-readable name for this action
Example:
Transfer to ManageractionParametersobjectrequired
Action parameters - structure varies by actionType