---
title: "Create Agent (Token Authentication)"
method: POST
path: "/ca_apis/createAgent"
tags: ["default"]
---

# Create Agent (Token Authentication)

`POST /ca_apis/createAgent`

Create a new agent in the system.

## Query parameters

- `detailedResponse` boolean

## Headers

- `Content-Type` string

## Request body

- object
  - `userName` string — CloudAgent account username
  - `agentId` string — Unique ID for the agent
  - `agentName` string — Full name of the agent
  - `password` string — Password for agent login
  - `email` string, email — Agent's email address
  - `autoAnswer` string — Auto answer setting for the agent (e.g., All, None, Inbound, Outbound.)
  - `sipLocation` string — SIP server location for the agent. Give the location name.
  - `agentData` string — Additional data for internal use.
  - `agentGroups` string — Comma-separated group names assigned to the agent
  - `screenRecording` boolean — Enable or disable screen recording
  - `inbound` boolean — Enable inbound calling mode
  - `manual` boolean — Enable manual calling mode
  - `preview` boolean — Enable preview dialing mode
  - `progressive` boolean — Enable progressive dialing mode
  - `chat` boolean — Enable chat mode
  - `blended` boolean — Enables blended mode
  - `blendedInbound` boolean — Enable inbound calls in blended mode
  - `blendedManual` boolean — Enable manual dialing in blended mode
  - `blendedPreview` boolean — Enable preview mode in blended setup
  - `blendedProgressive` boolean — Enable progressive dialing in blended setup
  - `blendedChat` boolean — Enable chat in blended mode
  - `callControls` object — Permissions for the agent on various call controls
    - `hold` boolean — Allows hold
    - `mute` boolean — Allows mute
    - `answer` boolean — Allows answering calls
    - `decline` boolean — Allows declining calls
    - `transfer_agent_warm` boolean — Warm transfer to another agent
    - `transfer_agent_blind` boolean — Blind transfer to another agent
    - `transfer_skill_warm` boolean — Warm transfer to another skill
    - `transfer_skill_blind` boolean — Blind transfer to another skill
    - `transfer_phone_warm` boolean — Warm transfer to a phone number
    - `transfer_phone_blind` boolean — Blind transfer to a phone number
    - `transfer_ivr_warm` boolean — Warm transfer to IVR
    - `transfer_ivr_blind` boolean — Blind transfer to IVR
    - `conference_agent` boolean — Enable conference with another agent
    - `conference_phone` boolean — Enable conference with a phone number
    - `endcall` boolean — Permission to end a call
    - `callrecording` boolean — Permission to start/stop call recording
    - `manualdial` boolean — Permission to dial manually
    - `disposition` boolean — Permission to update disposition
    - `dial_pad` boolean — Permission to use dialpad
  - `skills` object[] — List of skills assigned to the agent with priority levels
    - `priority` integer — Priority of the skill (1 is highest)
    - `skillName` string — Name of the skill assigned to the agent

## Response `200`

Successful response

---

[API](https://skmtc.net/ozonetel/apis/agent-authentication.md) · [All operations](https://skmtc.net/ozonetel/apis/agent-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ozonetel/agent-authentication/versions/9096baa9c71b/schema)