Create an agent from a template

Tool: create_workflow_from_template. Requires Editor, Admin, or Owner in the applicable workspace and a connected OAuth session. First call list_workflow_templates, then pass one returned key. Creates a draft-lifecycle agent, regenerates trigger identifiers, and checks conflicts. Outbound templates additionally require the Labs super_user role. Inspect created; failures can include template_not_found, superuser_required, organization_required, schema_validation, trigger_path_validation, qa_configuration, and trigger_path_conflict. Test and publish in the console before use. Repeating success creates another agent.

Arguments

Name	Type	Required	Defaults and limits
`template_key`	string	Yes	See full schema

Example arguments

Replace sample resource IDs with IDs returned in your selected workspace.

{
  "template_key": "inbound-receptionist"
}

Result and errors

The schema below describes MCP structuredContent, including the result wrapper where present. Your client may also display a text representation. Read success flags and structured errors before continuing; transport success alone does not prove the operation succeeded. Authentication, missing membership, and insufficient role can fail before a tool result is produced. See troubleshooting. Effect: Changes state. Retry: Do not blindly repeat successful calls. Discovery annotations describe behavior; they do not grant permission or replace confirmation for consequential actions.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "template_key": {
      "type": "string"
    }
  },
  "required": [
    "template_key"
  ],
  "type": "object"
}

Result schema

{
  "properties": {
    "result": {
      "anyOf": [
        {
          "properties": {
            "assistant_mode": {
              "enum": [
                "single_prompt",
                "workflow"
              ],
              "type": "string"
            },
            "created": {
              "const": true,
              "type": "boolean"
            },
            "edge_count": {
              "type": "integer"
            },
            "lifecycle_status": {
              "enum": [
                "draft",
                "active",
                "paused",
                "archived"
              ],
              "type": "string"
            },
            "name": {
              "type": "string"
            },
            "node_count": {
              "type": "integer"
            },
            "version_number": {
              "type": "integer"
            },
            "version_status": {
              "enum": [
                "draft",
                "published"
              ],
              "type": "string"
            },
            "workflow_id": {
              "type": "integer"
            }
          },
          "required": [
            "created",
            "workflow_id",
            "name",
            "lifecycle_status",
            "version_status",
            "version_number",
            "assistant_mode"
          ],
          "type": "object"
        },
        {
          "properties": {
            "created": {
              "const": false,
              "type": "boolean"
            },
            "error": {
              "type": "string"
            },
            "error_code": {
              "type": "string"
            },
            "errors": {
              "items": {
                "additionalProperties": true,
                "type": "object"
              },
              "type": "array"
            },
            "trigger_paths": {
              "items": {
                "type": "string"
              },
              "type": "array"
            }
          },
          "required": [
            "created",
            "error_code",
            "error"
          ],
          "type": "object"
        }
      ]
    }
  },
  "required": [
    "result"
  ],
  "type": "object"
}

Get started

Use MCP

Workspaces

Agents

Calls and outcomes

Phone numbers

Resources

Authoring guidance

Documentation

Arguments

Example arguments

Result and errors

​Arguments

​Example arguments

​Result and errors

Arguments

Example arguments

Result and errors