Actions42
- Agent Actions
- Channel Actions
- Chat Actions
- Intention Actions
- Interaction Actions
- Training Actions
- Workspace Actions
Agent → Create
AI-generatedSummary
Create a new agent in a workspace via POST /v2/workspace/{workspaceId}/agents.
Inputs
- workspaceId (required) — Select the workspace for workspace-scoped agent endpoints. Choose from the list, or specify an ID using an expression.
- name (required) — Agent name
- behavior (required) — Agent behavior/instructions
- communicationType (required) — How the agent should communicate (FORMAL, NORMAL, or RELAXED)
- agentType (required) — Agent objective/type (SUPPORT, SALE, or PERSONAL)
- avatar — Optional agent avatar URL
- jobName — Company/product name the agent represents
- jobSite — Company website
- jobDescription — Short description about the company/product
Output shape
The GPTMaker API returns the created agent object.
The node constructs a JSON body with the provided fields, omitting empty optional strings. A workspace ID is mandatory; without it the operation throws an error.
Examples
Example 1: Create a support agent named 'Customer Help' in workspace 'ws_123' with formal communication and SUPPORT type.
Set workspaceId to 'ws_123', name to 'Customer Help', behavior to a descriptive prompt, communicationType to 'FORMAL', and agentType to 'SUPPORT'. Leave avatar, jobName, jobSite, and jobDescription empty or omit them.