import requests
url = "https://api.pingr.ai/api/v1/agents"
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
payload = {
"name": "Customer Support Concierge",
"agent_type": "prompt",
"timezone": "America/New_York",
"agent_config": {
"welcome_message": "Hello! Thank you for calling Pingr AI support. How can I assist you today?",
"system_prompt": "You are a professional customer support specialist for Pingr AI. Answer inquiries politely and concisely.",
"language": "en-US",
"llm_provider": "openai",
"llm_model": "gpt-4o-mini",
"voice_settings": {
"voice_id": "79a125e8-cd45-4c13-8a67-188112f4dd22",
"name": "British Friendly Male",
"provider": "cartesia"
}
}
}
response = requests.post(url, json=payload, headers=headers)
print(response.status_code)
print(response.json())
const response = await fetch("https://api.pingr.ai/api/v1/agents", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify({
name: "Customer Support Concierge",
agent_type: "prompt",
timezone: "America/New_York",
agent_config: {
welcome_message: "Hello! Thank you for calling Pingr AI support. How can I assist you today?",
system_prompt: "You are a professional customer support specialist for Pingr AI. Answer inquiries politely and concisely.",
language: "en-US",
llm_provider: "openai",
llm_model: "gpt-4o-mini",
voice_settings: {
voice_id: "79a125e8-cd45-4c13-8a67-188112f4dd22",
name: "British Friendly Male",
provider: "cartesia"
}
}
})
});
const data = await response.json();
console.log(data);
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.pingr.ai/api/v1/agents"))
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString("""
{
"name": "Customer Support Concierge",
"agent_type": "prompt",
"agent_config": {
"welcome_message": "Hello! Thank you for calling Pingr AI.",
"language": "en-US",
"llm_model": "gpt-4o-mini"
}
}
"""))
.build();
HttpResponse<String> response =
HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
curl -X POST "https://api.pingr.ai/api/v1/agents" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"name": "Customer Support Concierge",
"agent_type": "prompt",
"timezone": "America/New_York",
"agent_config": {
"welcome_message": "Hello! Thank you for calling Pingr AI support.",
"language": "en-US",
"llm_model": "gpt-4o-mini"
}
}'
{
"id": "e4b2d184-7cf1-4560-a292-6284649bcf2e",
"name": "Customer Support Concierge",
"organization_id": "93f35dc2-5d46-4e58-a9ee-038c35d9bcf1",
"timezone": "America/New_York",
"agent_type": "prompt",
"is_active": "active",
"created_at": "2026-09-03T12:00:00Z",
"updated_at": "2026-09-03T12:00:00Z"
}
{
"error": 400,
"message": "Validation error: agent 'name' is required and must not be empty"
}
{
"error": 401,
"message": "Unauthorized"
}
{
"error": 500,
"message": "Internal server error"
}
Agents
Create agent
Provision a new conversational Voice AI prompt agent or rule-based static bot
POST
/
api
/
v1
/
agents
import requests
url = "https://api.pingr.ai/api/v1/agents"
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
payload = {
"name": "Customer Support Concierge",
"agent_type": "prompt",
"timezone": "America/New_York",
"agent_config": {
"welcome_message": "Hello! Thank you for calling Pingr AI support. How can I assist you today?",
"system_prompt": "You are a professional customer support specialist for Pingr AI. Answer inquiries politely and concisely.",
"language": "en-US",
"llm_provider": "openai",
"llm_model": "gpt-4o-mini",
"voice_settings": {
"voice_id": "79a125e8-cd45-4c13-8a67-188112f4dd22",
"name": "British Friendly Male",
"provider": "cartesia"
}
}
}
response = requests.post(url, json=payload, headers=headers)
print(response.status_code)
print(response.json())
const response = await fetch("https://api.pingr.ai/api/v1/agents", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify({
name: "Customer Support Concierge",
agent_type: "prompt",
timezone: "America/New_York",
agent_config: {
welcome_message: "Hello! Thank you for calling Pingr AI support. How can I assist you today?",
system_prompt: "You are a professional customer support specialist for Pingr AI. Answer inquiries politely and concisely.",
language: "en-US",
llm_provider: "openai",
llm_model: "gpt-4o-mini",
voice_settings: {
voice_id: "79a125e8-cd45-4c13-8a67-188112f4dd22",
name: "British Friendly Male",
provider: "cartesia"
}
}
})
});
const data = await response.json();
console.log(data);
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.pingr.ai/api/v1/agents"))
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString("""
{
"name": "Customer Support Concierge",
"agent_type": "prompt",
"agent_config": {
"welcome_message": "Hello! Thank you for calling Pingr AI.",
"language": "en-US",
"llm_model": "gpt-4o-mini"
}
}
"""))
.build();
HttpResponse<String> response =
HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
curl -X POST "https://api.pingr.ai/api/v1/agents" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"name": "Customer Support Concierge",
"agent_type": "prompt",
"timezone": "America/New_York",
"agent_config": {
"welcome_message": "Hello! Thank you for calling Pingr AI support.",
"language": "en-US",
"llm_model": "gpt-4o-mini"
}
}'
{
"id": "e4b2d184-7cf1-4560-a292-6284649bcf2e",
"name": "Customer Support Concierge",
"organization_id": "93f35dc2-5d46-4e58-a9ee-038c35d9bcf1",
"timezone": "America/New_York",
"agent_type": "prompt",
"is_active": "active",
"created_at": "2026-09-03T12:00:00Z",
"updated_at": "2026-09-03T12:00:00Z"
}
{
"error": 400,
"message": "Validation error: agent 'name' is required and must not be empty"
}
{
"error": 401,
"message": "Unauthorized"
}
{
"error": 500,
"message": "Internal server error"
}
Create a new Voice AI agent under your organization with customized voice synthesis, LLM parameters, system instructions, and real-time tool bindings.
Authentication
This endpoint requires Bearer token authentication.Authorization: Bearer <token>
Input parameters
The following parameters are accepted in the request body.string
required
Bearer token for authentication. Format:
Bearer <token>.string
required
Descriptive name of the voice agent (e.g.
Inbound Support Specialist).string
default:"prompt"
Architecture pattern of the agent:
prompt: Autonomous LLM-driven voice agent.static: Deterministic rule-based decision bot.
string
Operational timezone for calendar and campaign calculations (e.g.
America/New_York, UTC).object
Detailed runtime configurations and tool integrations:
Show agent_config attributes
Show agent_config attributes
string
Initial greeting spoken immediately as soon as the recipient answers.
string
Core directive and instructions establishing the agent’s persona and constraints.
string
default:"en-US"
Primary spoken language tag.
string
default:"openai"
Model hosting provider (
openai, anthropic, groq).string
default:"gpt-4o-mini"
LLM model identifier (
gpt-4o, gpt-4o-mini, claude-3-5-sonnet).object
object
object[]
Array of dynamic REST API tools the agent can execute mid-call.
object[]
Array of Model Context Protocol (MCP) server configurations.
Response Fields
string
Generated unique UUID identifier for the created agent.
string
Agent display name.
string
UUID of the owning organization.
string
Configured agent type (
prompt or static).string
Initial operational status (
active or inactive).string
Timestamp of creation in ISO 8601 format.
import requests
url = "https://api.pingr.ai/api/v1/agents"
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
payload = {
"name": "Customer Support Concierge",
"agent_type": "prompt",
"timezone": "America/New_York",
"agent_config": {
"welcome_message": "Hello! Thank you for calling Pingr AI support. How can I assist you today?",
"system_prompt": "You are a professional customer support specialist for Pingr AI. Answer inquiries politely and concisely.",
"language": "en-US",
"llm_provider": "openai",
"llm_model": "gpt-4o-mini",
"voice_settings": {
"voice_id": "79a125e8-cd45-4c13-8a67-188112f4dd22",
"name": "British Friendly Male",
"provider": "cartesia"
}
}
}
response = requests.post(url, json=payload, headers=headers)
print(response.status_code)
print(response.json())
const response = await fetch("https://api.pingr.ai/api/v1/agents", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify({
name: "Customer Support Concierge",
agent_type: "prompt",
timezone: "America/New_York",
agent_config: {
welcome_message: "Hello! Thank you for calling Pingr AI support. How can I assist you today?",
system_prompt: "You are a professional customer support specialist for Pingr AI. Answer inquiries politely and concisely.",
language: "en-US",
llm_provider: "openai",
llm_model: "gpt-4o-mini",
voice_settings: {
voice_id: "79a125e8-cd45-4c13-8a67-188112f4dd22",
name: "British Friendly Male",
provider: "cartesia"
}
}
})
});
const data = await response.json();
console.log(data);
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.pingr.ai/api/v1/agents"))
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString("""
{
"name": "Customer Support Concierge",
"agent_type": "prompt",
"agent_config": {
"welcome_message": "Hello! Thank you for calling Pingr AI.",
"language": "en-US",
"llm_model": "gpt-4o-mini"
}
}
"""))
.build();
HttpResponse<String> response =
HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
curl -X POST "https://api.pingr.ai/api/v1/agents" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"name": "Customer Support Concierge",
"agent_type": "prompt",
"timezone": "America/New_York",
"agent_config": {
"welcome_message": "Hello! Thank you for calling Pingr AI support.",
"language": "en-US",
"llm_model": "gpt-4o-mini"
}
}'
{
"id": "e4b2d184-7cf1-4560-a292-6284649bcf2e",
"name": "Customer Support Concierge",
"organization_id": "93f35dc2-5d46-4e58-a9ee-038c35d9bcf1",
"timezone": "America/New_York",
"agent_type": "prompt",
"is_active": "active",
"created_at": "2026-09-03T12:00:00Z",
"updated_at": "2026-09-03T12:00:00Z"
}
{
"error": 400,
"message": "Validation error: agent 'name' is required and must not be empty"
}
{
"error": 401,
"message": "Unauthorized"
}
{
"error": 500,
"message": "Internal server error"
}
‹ PreviousNext ›
List agents
Retrieve all Voice AI agents for organization
Was this page helpful?