Skip to main content
POST
https://api.nedzo.ai/v1
/
agents
curl -X POST "https://api.nedzo.ai/v1/agents" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "Customer Support Agent",
      "agentType": "Inbound Voice",
      "workspaceId": "123e4567-e89b-12d3-a456-426614174000",
      "prompt": "You are a helpful customer support assistant.",
      "openingLine": "Hello! How can I help you today?",
      "language": "english",
      "voiceId": "voice_123",
      "voicemail": false,
      "voicemailMessage": "Please leave a message after the tone.",
      "backgroundSound": true,
      "callDuration": 30
    }'

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Customer Support Agent",
  "agentType": "Inbound Voice",
  "prompt": "You are a helpful customer support assistant.",
  "isActive": true,
  "backgroundSound": true,
  "openingLine": "Hello! How can I help you today?",
  "language": "english",
  "voicemail": false,
  "voicemailMessage": null,
  "hipaaCompliance": false,
  "callDuration": 30,
  "speed": 1.0,
  "voiceId": "voice_123",
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:30:00Z"
}
Create a new agent within a workspace.

​
Common Fields

​
name
string
required
Agent name (1-255 characters)
​
agentType
string
required
Type of agent to create. Valid values: Inbound Voice, Outbound Voice, Chat, Widget
​
workspaceId
string
Workspace UUID (required for account API keys, optional for workspace API keys)
​
prompt
string
System prompt for the agent
​
language
string
Agent language. Valid values: english, spanish, french, german, portuguese, dutch, chinese, japanese (default: “english”)
​
isActive
boolean
Whether the agent is active (default: true)

​
Type-Specific Fields

​
openingLine
string
Opening line the agent says when starting a conversation
​
voiceId
string
Voice ID for text-to-speech
​
backgroundSound
boolean
Enable background sound (default: true)
​
hipaaCompliance
boolean
When this is enabled, no logs, recordings, or transcriptions will be stored (default: false)
​
callDuration
integer
Maximum call duration in minutes, 1-60 (default: 30)
​
speed
number
Voice speed multiplier, 0.5-1.5 (default: 1.0)
curl -X POST "https://api.nedzo.ai/v1/agents" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "Customer Support Agent",
      "agentType": "Inbound Voice",
      "workspaceId": "123e4567-e89b-12d3-a456-426614174000",
      "prompt": "You are a helpful customer support assistant.",
      "openingLine": "Hello! How can I help you today?",
      "language": "english",
      "voiceId": "voice_123",
      "voicemail": false,
      "voicemailMessage": "Please leave a message after the tone.",
      "backgroundSound": true,
      "callDuration": 30
    }'

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Customer Support Agent",
  "agentType": "Inbound Voice",
  "prompt": "You are a helpful customer support assistant.",
  "isActive": true,
  "backgroundSound": true,
  "openingLine": "Hello! How can I help you today?",
  "language": "english",
  "voicemail": false,
  "voicemailMessage": null,
  "hipaaCompliance": false,
  "callDuration": 30,
  "speed": 1.0,
  "voiceId": "voice_123",
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:30:00Z"
}