Skip to main content
POST
/
v1
/
organizations
/
{organization_id}
/
agents
curl -X POST "https://api.telzino.com/v1/organizations/org-abc12345-e89b-12d3-a456-426614174000/agents" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Support Bot",
    "description": "Handles support tickets",
    "external_id": "external-agent-123"
  }'

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

​
Overview

Creates a minimal agent (title, description, external_id) under the given organization. For creating an agent with full configuration (voice, prompts, model, etc.) use POST /v1/agents instead.

​
Path Parameters

​
organization_id
string
required
Organization ID (UUID) to create the agent under

​
Request Body

​
title
string
required
Name of the agent (1–255 characters)
​
description
string
Description of what the agent does (max 1000 characters)
​
external_id
string
External identifier for integration with your systems (max 255 characters)
curl -X POST "https://api.telzino.com/v1/organizations/org-abc12345-e89b-12d3-a456-426614174000/agents" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Support Bot",
    "description": "Handles support tickets",
    "external_id": "external-agent-123"
  }'

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

​
Response Fields

FieldTypeDescription
idstring (UUID)ID of the newly created agent