curl --request POST \ --url https://api.heify.com/create-evaluator \ --header 'Content-Type: application/json' \ --header 'x-api-key: <api-key>' \ --data '{ "tag": "nombre de ejemplo", "description": "descripcion opcional", "language": "df", "context": "You are evaluating a salesperson during a sales call or meeting with a prospect or client. Assess their ability to identify needs, communicate value and handle objections.", "criteria": [ { "name": "Cierre de Venta", "description": "El agente debe solicitar explicitamente la venta o el compromiso del cliente utilizando tecnicas de cierre directas como \"¿Procedemos con la contratacion?\" o \"¿Le gustaria activar el servicio hoy?\". No debe finalizar la llamada sin haber intentado cerrar al menos una vez.", "type": "boolean", "weight": 50 }, { "name": "Escucha Activa", "description": "El agente no interrumpe al cliente mientras expone su problema, confirma los datos clave repitiendo o parafraseando lo escuchado y realiza preguntas relevantes para entender la situacion completa antes de ofrecer una solucion.", "type": "strict", "weight": 0 }, { "name": "Empatia", "description": "El agente muestra comprension ante la situacion del cliente utilizando frases de reconocimiento como \"Entiendo su frustracion\", \"Lamento las molestias\" o \"Comprendo lo importante que es esto para usted\". No debe minimizar el problema ni usar un tono condescendiente.", "type": "scale", "weight": 50 } ]}'
import requests
url = "https://api.heify.com/create-evaluator"
payload = {
"tag": "nombre de ejemplo",
"description": "descripcion opcional",
"language": "df",
"context": "You are evaluating a salesperson during a sales call or meeting with a prospect or client. Assess their ability to identify needs, communicate value and handle objections.",
"criteria": [
{
"name": "Cierre de Venta",
"description": "El agente debe solicitar explicitamente la venta o el compromiso del cliente utilizando tecnicas de cierre directas como \"¿Procedemos con la contratacion?\" o \"¿Le gustaria activar el servicio hoy?\". No debe finalizar la llamada sin haber intentado cerrar al menos una vez.",
"type": "boolean",
"weight": 50
},
{
"name": "Escucha Activa",
"description": "El agente no interrumpe al cliente mientras expone su problema, confirma los datos clave repitiendo o parafraseando lo escuchado y realiza preguntas relevantes para entender la situacion completa antes de ofrecer una solucion.",
"type": "strict",
"weight": 0
},
{
"name": "Empatia",
"description": "El agente muestra comprension ante la situacion del cliente utilizando frases de reconocimiento como \"Entiendo su frustracion\", \"Lamento las molestias\" o \"Comprendo lo importante que es esto para usted\". No debe minimizar el problema ni usar un tono condescendiente.",
"type": "scale",
"weight": 50
}
]
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)
const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
tag: 'nombre de ejemplo',
description: 'descripcion opcional',
language: 'df',
context: 'You are evaluating a salesperson during a sales call or meeting with a prospect or client. Assess their ability to identify needs, communicate value and handle objections.',
criteria: [
{
name: 'Cierre de Venta',
description: 'El agente debe solicitar explicitamente la venta o el compromiso del cliente utilizando tecnicas de cierre directas como "¿Procedemos con la contratacion?" o "¿Le gustaria activar el servicio hoy?". No debe finalizar la llamada sin haber intentado cerrar al menos una vez.',
type: 'boolean',
weight: 50
},
{
name: 'Escucha Activa',
description: 'El agente no interrumpe al cliente mientras expone su problema, confirma los datos clave repitiendo o parafraseando lo escuchado y realiza preguntas relevantes para entender la situacion completa antes de ofrecer una solucion.',
type: 'strict',
weight: 0
},
{
name: 'Empatia',
description: 'El agente muestra comprension ante la situacion del cliente utilizando frases de reconocimiento como "Entiendo su frustracion", "Lamento las molestias" o "Comprendo lo importante que es esto para usted". No debe minimizar el problema ni usar un tono condescendiente.',
type: 'scale',
weight: 50
}
]
})
};
fetch('https://api.heify.com/create-evaluator', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.heify.com/create-evaluator",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'tag' => 'nombre de ejemplo',
'description' => 'descripcion opcional',
'language' => 'df',
'context' => 'You are evaluating a salesperson during a sales call or meeting with a prospect or client. Assess their ability to identify needs, communicate value and handle objections.',
'criteria' => [
[
'name' => 'Cierre de Venta',
'description' => 'El agente debe solicitar explicitamente la venta o el compromiso del cliente utilizando tecnicas de cierre directas como "¿Procedemos con la contratacion?" o "¿Le gustaria activar el servicio hoy?". No debe finalizar la llamada sin haber intentado cerrar al menos una vez.',
'type' => 'boolean',
'weight' => 50
],
[
'name' => 'Escucha Activa',
'description' => 'El agente no interrumpe al cliente mientras expone su problema, confirma los datos clave repitiendo o parafraseando lo escuchado y realiza preguntas relevantes para entender la situacion completa antes de ofrecer una solucion.',
'type' => 'strict',
'weight' => 0
],
[
'name' => 'Empatia',
'description' => 'El agente muestra comprension ante la situacion del cliente utilizando frases de reconocimiento como "Entiendo su frustracion", "Lamento las molestias" o "Comprendo lo importante que es esto para usted". No debe minimizar el problema ni usar un tono condescendiente.',
'type' => 'scale',
'weight' => 50
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.heify.com/create-evaluator"
payload := strings.NewReader("{\n \"tag\": \"nombre de ejemplo\",\n \"description\": \"descripcion opcional\",\n \"language\": \"df\",\n \"context\": \"You are evaluating a salesperson during a sales call or meeting with a prospect or client. Assess their ability to identify needs, communicate value and handle objections.\",\n \"criteria\": [\n {\n \"name\": \"Cierre de Venta\",\n \"description\": \"El agente debe solicitar explicitamente la venta o el compromiso del cliente utilizando tecnicas de cierre directas como \\\"¿Procedemos con la contratacion?\\\" o \\\"¿Le gustaria activar el servicio hoy?\\\". No debe finalizar la llamada sin haber intentado cerrar al menos una vez.\",\n \"type\": \"boolean\",\n \"weight\": 50\n },\n {\n \"name\": \"Escucha Activa\",\n \"description\": \"El agente no interrumpe al cliente mientras expone su problema, confirma los datos clave repitiendo o parafraseando lo escuchado y realiza preguntas relevantes para entender la situacion completa antes de ofrecer una solucion.\",\n \"type\": \"strict\",\n \"weight\": 0\n },\n {\n \"name\": \"Empatia\",\n \"description\": \"El agente muestra comprension ante la situacion del cliente utilizando frases de reconocimiento como \\\"Entiendo su frustracion\\\", \\\"Lamento las molestias\\\" o \\\"Comprendo lo importante que es esto para usted\\\". No debe minimizar el problema ni usar un tono condescendiente.\",\n \"type\": \"scale\",\n \"weight\": 50\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}
HttpResponse<String> response = Unirest.post("https://api.heify.com/create-evaluator")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"tag\": \"nombre de ejemplo\",\n \"description\": \"descripcion opcional\",\n \"language\": \"df\",\n \"context\": \"You are evaluating a salesperson during a sales call or meeting with a prospect or client. Assess their ability to identify needs, communicate value and handle objections.\",\n \"criteria\": [\n {\n \"name\": \"Cierre de Venta\",\n \"description\": \"El agente debe solicitar explicitamente la venta o el compromiso del cliente utilizando tecnicas de cierre directas como \\\"¿Procedemos con la contratacion?\\\" o \\\"¿Le gustaria activar el servicio hoy?\\\". No debe finalizar la llamada sin haber intentado cerrar al menos una vez.\",\n \"type\": \"boolean\",\n \"weight\": 50\n },\n {\n \"name\": \"Escucha Activa\",\n \"description\": \"El agente no interrumpe al cliente mientras expone su problema, confirma los datos clave repitiendo o parafraseando lo escuchado y realiza preguntas relevantes para entender la situacion completa antes de ofrecer una solucion.\",\n \"type\": \"strict\",\n \"weight\": 0\n },\n {\n \"name\": \"Empatia\",\n \"description\": \"El agente muestra comprension ante la situacion del cliente utilizando frases de reconocimiento como \\\"Entiendo su frustracion\\\", \\\"Lamento las molestias\\\" o \\\"Comprendo lo importante que es esto para usted\\\". No debe minimizar el problema ni usar un tono condescendiente.\",\n \"type\": \"scale\",\n \"weight\": 50\n }\n ]\n}")
.asString();
require 'uri'
require 'net/http'
url = URI("https://api.heify.com/create-evaluator")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"tag\": \"nombre de ejemplo\",\n \"description\": \"descripcion opcional\",\n \"language\": \"df\",\n \"context\": \"You are evaluating a salesperson during a sales call or meeting with a prospect or client. Assess their ability to identify needs, communicate value and handle objections.\",\n \"criteria\": [\n {\n \"name\": \"Cierre de Venta\",\n \"description\": \"El agente debe solicitar explicitamente la venta o el compromiso del cliente utilizando tecnicas de cierre directas como \\\"¿Procedemos con la contratacion?\\\" o \\\"¿Le gustaria activar el servicio hoy?\\\". No debe finalizar la llamada sin haber intentado cerrar al menos una vez.\",\n \"type\": \"boolean\",\n \"weight\": 50\n },\n {\n \"name\": \"Escucha Activa\",\n \"description\": \"El agente no interrumpe al cliente mientras expone su problema, confirma los datos clave repitiendo o parafraseando lo escuchado y realiza preguntas relevantes para entender la situacion completa antes de ofrecer una solucion.\",\n \"type\": \"strict\",\n \"weight\": 0\n },\n {\n \"name\": \"Empatia\",\n \"description\": \"El agente muestra comprension ante la situacion del cliente utilizando frases de reconocimiento como \\\"Entiendo su frustracion\\\", \\\"Lamento las molestias\\\" o \\\"Comprendo lo importante que es esto para usted\\\". No debe minimizar el problema ni usar un tono condescendiente.\",\n \"type\": \"scale\",\n \"weight\": 50\n }\n ]\n}"
response = http.request(request)
puts response.read_body
{ "data": { "message": "Evaluator created successfully", "evaluator": { "evaluator_id": "47e865ea-67ee-4930-9064-0a07db10c6b3", "tag": "nombre de ejemplo", "description": "descripcion opcional", "language": "df", "context": "You are evaluating a salesperson during a sales call or meeting with a prospect or client. Assess their ability to identify needs, communicate value and handle objections.", "criteria": [ { "id": "f5ccfa19-40d1-4d0c-aee5-4217a5a22485", "name": "Cierre de Venta", "description": "El agente debe solicitar explicitamente la venta...", "type": "boolean", "weight": 50 }, { "id": "beaac9a5-a067-4413-9721-874e3ccda50c", "name": "Escucha Activa", "description": "El agente no interrumpe al cliente...", "type": "strict", "weight": 0 }, { "id": "0daee516-3b0f-40b5-836e-f0850365d355", "name": "Empatia", "description": "El agente muestra comprension ante la situacion del cliente...", "type": "scale", "weight": 50 } ], "created_at": "2026-03-21T14:19:57.834336+00:00" } }}
Evaluators
Create Evaluator
Create a new evaluator with its evaluation criteria.
POST
/
create-evaluator
Create Evaluator
curl --request POST \ --url https://api.heify.com/create-evaluator \ --header 'Content-Type: application/json' \ --header 'x-api-key: <api-key>' \ --data '{ "tag": "nombre de ejemplo", "description": "descripcion opcional", "language": "df", "context": "You are evaluating a salesperson during a sales call or meeting with a prospect or client. Assess their ability to identify needs, communicate value and handle objections.", "criteria": [ { "name": "Cierre de Venta", "description": "El agente debe solicitar explicitamente la venta o el compromiso del cliente utilizando tecnicas de cierre directas como \"¿Procedemos con la contratacion?\" o \"¿Le gustaria activar el servicio hoy?\". No debe finalizar la llamada sin haber intentado cerrar al menos una vez.", "type": "boolean", "weight": 50 }, { "name": "Escucha Activa", "description": "El agente no interrumpe al cliente mientras expone su problema, confirma los datos clave repitiendo o parafraseando lo escuchado y realiza preguntas relevantes para entender la situacion completa antes de ofrecer una solucion.", "type": "strict", "weight": 0 }, { "name": "Empatia", "description": "El agente muestra comprension ante la situacion del cliente utilizando frases de reconocimiento como \"Entiendo su frustracion\", \"Lamento las molestias\" o \"Comprendo lo importante que es esto para usted\". No debe minimizar el problema ni usar un tono condescendiente.", "type": "scale", "weight": 50 } ]}'
import requests
url = "https://api.heify.com/create-evaluator"
payload = {
"tag": "nombre de ejemplo",
"description": "descripcion opcional",
"language": "df",
"context": "You are evaluating a salesperson during a sales call or meeting with a prospect or client. Assess their ability to identify needs, communicate value and handle objections.",
"criteria": [
{
"name": "Cierre de Venta",
"description": "El agente debe solicitar explicitamente la venta o el compromiso del cliente utilizando tecnicas de cierre directas como \"¿Procedemos con la contratacion?\" o \"¿Le gustaria activar el servicio hoy?\". No debe finalizar la llamada sin haber intentado cerrar al menos una vez.",
"type": "boolean",
"weight": 50
},
{
"name": "Escucha Activa",
"description": "El agente no interrumpe al cliente mientras expone su problema, confirma los datos clave repitiendo o parafraseando lo escuchado y realiza preguntas relevantes para entender la situacion completa antes de ofrecer una solucion.",
"type": "strict",
"weight": 0
},
{
"name": "Empatia",
"description": "El agente muestra comprension ante la situacion del cliente utilizando frases de reconocimiento como \"Entiendo su frustracion\", \"Lamento las molestias\" o \"Comprendo lo importante que es esto para usted\". No debe minimizar el problema ni usar un tono condescendiente.",
"type": "scale",
"weight": 50
}
]
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)
const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
tag: 'nombre de ejemplo',
description: 'descripcion opcional',
language: 'df',
context: 'You are evaluating a salesperson during a sales call or meeting with a prospect or client. Assess their ability to identify needs, communicate value and handle objections.',
criteria: [
{
name: 'Cierre de Venta',
description: 'El agente debe solicitar explicitamente la venta o el compromiso del cliente utilizando tecnicas de cierre directas como "¿Procedemos con la contratacion?" o "¿Le gustaria activar el servicio hoy?". No debe finalizar la llamada sin haber intentado cerrar al menos una vez.',
type: 'boolean',
weight: 50
},
{
name: 'Escucha Activa',
description: 'El agente no interrumpe al cliente mientras expone su problema, confirma los datos clave repitiendo o parafraseando lo escuchado y realiza preguntas relevantes para entender la situacion completa antes de ofrecer una solucion.',
type: 'strict',
weight: 0
},
{
name: 'Empatia',
description: 'El agente muestra comprension ante la situacion del cliente utilizando frases de reconocimiento como "Entiendo su frustracion", "Lamento las molestias" o "Comprendo lo importante que es esto para usted". No debe minimizar el problema ni usar un tono condescendiente.',
type: 'scale',
weight: 50
}
]
})
};
fetch('https://api.heify.com/create-evaluator', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.heify.com/create-evaluator",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'tag' => 'nombre de ejemplo',
'description' => 'descripcion opcional',
'language' => 'df',
'context' => 'You are evaluating a salesperson during a sales call or meeting with a prospect or client. Assess their ability to identify needs, communicate value and handle objections.',
'criteria' => [
[
'name' => 'Cierre de Venta',
'description' => 'El agente debe solicitar explicitamente la venta o el compromiso del cliente utilizando tecnicas de cierre directas como "¿Procedemos con la contratacion?" o "¿Le gustaria activar el servicio hoy?". No debe finalizar la llamada sin haber intentado cerrar al menos una vez.',
'type' => 'boolean',
'weight' => 50
],
[
'name' => 'Escucha Activa',
'description' => 'El agente no interrumpe al cliente mientras expone su problema, confirma los datos clave repitiendo o parafraseando lo escuchado y realiza preguntas relevantes para entender la situacion completa antes de ofrecer una solucion.',
'type' => 'strict',
'weight' => 0
],
[
'name' => 'Empatia',
'description' => 'El agente muestra comprension ante la situacion del cliente utilizando frases de reconocimiento como "Entiendo su frustracion", "Lamento las molestias" o "Comprendo lo importante que es esto para usted". No debe minimizar el problema ni usar un tono condescendiente.',
'type' => 'scale',
'weight' => 50
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.heify.com/create-evaluator"
payload := strings.NewReader("{\n \"tag\": \"nombre de ejemplo\",\n \"description\": \"descripcion opcional\",\n \"language\": \"df\",\n \"context\": \"You are evaluating a salesperson during a sales call or meeting with a prospect or client. Assess their ability to identify needs, communicate value and handle objections.\",\n \"criteria\": [\n {\n \"name\": \"Cierre de Venta\",\n \"description\": \"El agente debe solicitar explicitamente la venta o el compromiso del cliente utilizando tecnicas de cierre directas como \\\"¿Procedemos con la contratacion?\\\" o \\\"¿Le gustaria activar el servicio hoy?\\\". No debe finalizar la llamada sin haber intentado cerrar al menos una vez.\",\n \"type\": \"boolean\",\n \"weight\": 50\n },\n {\n \"name\": \"Escucha Activa\",\n \"description\": \"El agente no interrumpe al cliente mientras expone su problema, confirma los datos clave repitiendo o parafraseando lo escuchado y realiza preguntas relevantes para entender la situacion completa antes de ofrecer una solucion.\",\n \"type\": \"strict\",\n \"weight\": 0\n },\n {\n \"name\": \"Empatia\",\n \"description\": \"El agente muestra comprension ante la situacion del cliente utilizando frases de reconocimiento como \\\"Entiendo su frustracion\\\", \\\"Lamento las molestias\\\" o \\\"Comprendo lo importante que es esto para usted\\\". No debe minimizar el problema ni usar un tono condescendiente.\",\n \"type\": \"scale\",\n \"weight\": 50\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}
HttpResponse<String> response = Unirest.post("https://api.heify.com/create-evaluator")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"tag\": \"nombre de ejemplo\",\n \"description\": \"descripcion opcional\",\n \"language\": \"df\",\n \"context\": \"You are evaluating a salesperson during a sales call or meeting with a prospect or client. Assess their ability to identify needs, communicate value and handle objections.\",\n \"criteria\": [\n {\n \"name\": \"Cierre de Venta\",\n \"description\": \"El agente debe solicitar explicitamente la venta o el compromiso del cliente utilizando tecnicas de cierre directas como \\\"¿Procedemos con la contratacion?\\\" o \\\"¿Le gustaria activar el servicio hoy?\\\". No debe finalizar la llamada sin haber intentado cerrar al menos una vez.\",\n \"type\": \"boolean\",\n \"weight\": 50\n },\n {\n \"name\": \"Escucha Activa\",\n \"description\": \"El agente no interrumpe al cliente mientras expone su problema, confirma los datos clave repitiendo o parafraseando lo escuchado y realiza preguntas relevantes para entender la situacion completa antes de ofrecer una solucion.\",\n \"type\": \"strict\",\n \"weight\": 0\n },\n {\n \"name\": \"Empatia\",\n \"description\": \"El agente muestra comprension ante la situacion del cliente utilizando frases de reconocimiento como \\\"Entiendo su frustracion\\\", \\\"Lamento las molestias\\\" o \\\"Comprendo lo importante que es esto para usted\\\". No debe minimizar el problema ni usar un tono condescendiente.\",\n \"type\": \"scale\",\n \"weight\": 50\n }\n ]\n}")
.asString();
require 'uri'
require 'net/http'
url = URI("https://api.heify.com/create-evaluator")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"tag\": \"nombre de ejemplo\",\n \"description\": \"descripcion opcional\",\n \"language\": \"df\",\n \"context\": \"You are evaluating a salesperson during a sales call or meeting with a prospect or client. Assess their ability to identify needs, communicate value and handle objections.\",\n \"criteria\": [\n {\n \"name\": \"Cierre de Venta\",\n \"description\": \"El agente debe solicitar explicitamente la venta o el compromiso del cliente utilizando tecnicas de cierre directas como \\\"¿Procedemos con la contratacion?\\\" o \\\"¿Le gustaria activar el servicio hoy?\\\". No debe finalizar la llamada sin haber intentado cerrar al menos una vez.\",\n \"type\": \"boolean\",\n \"weight\": 50\n },\n {\n \"name\": \"Escucha Activa\",\n \"description\": \"El agente no interrumpe al cliente mientras expone su problema, confirma los datos clave repitiendo o parafraseando lo escuchado y realiza preguntas relevantes para entender la situacion completa antes de ofrecer una solucion.\",\n \"type\": \"strict\",\n \"weight\": 0\n },\n {\n \"name\": \"Empatia\",\n \"description\": \"El agente muestra comprension ante la situacion del cliente utilizando frases de reconocimiento como \\\"Entiendo su frustracion\\\", \\\"Lamento las molestias\\\" o \\\"Comprendo lo importante que es esto para usted\\\". No debe minimizar el problema ni usar un tono condescendiente.\",\n \"type\": \"scale\",\n \"weight\": 50\n }\n ]\n}"
response = http.request(request)
puts response.read_body
{ "data": { "message": "Evaluator created successfully", "evaluator": { "evaluator_id": "47e865ea-67ee-4930-9064-0a07db10c6b3", "tag": "nombre de ejemplo", "description": "descripcion opcional", "language": "df", "context": "You are evaluating a salesperson during a sales call or meeting with a prospect or client. Assess their ability to identify needs, communicate value and handle objections.", "criteria": [ { "id": "f5ccfa19-40d1-4d0c-aee5-4217a5a22485", "name": "Cierre de Venta", "description": "El agente debe solicitar explicitamente la venta...", "type": "boolean", "weight": 50 }, { "id": "beaac9a5-a067-4413-9721-874e3ccda50c", "name": "Escucha Activa", "description": "El agente no interrumpe al cliente...", "type": "strict", "weight": 0 }, { "id": "0daee516-3b0f-40b5-836e-f0850365d355", "name": "Empatia", "description": "El agente muestra comprension ante la situacion del cliente...", "type": "scale", "weight": 50 } ], "created_at": "2026-03-21T14:19:57.834336+00:00" } }}
The sum of all non-strict criterion weights must equal exactly 100. The weight of strict criteria is automatically set to 0 regardless of what you send.
The description of each criterion is the text the AI uses to evaluate the call. A clear, specific description directly improves evaluation accuracy. For guidance on writing effective criteria, see Evaluator — criteria.
language defaults to "df" (auto-detect from audio). See Evaluator — language for supported language codes.
Maximum 20 evaluators per account and 10 criteria per evaluator. See Rate Limits & Quotas.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Heify Docs","colors":{"primary":"#3B82F6","light":"#60A5FA","dark":"#2563EB"},"logo":{"light":"https://mintcdn.com/heify/8fipfniSVMLrex-g/logo/light.svg?fit=max\u0026auto=format\u0026n=8fipfniSVMLrex-g\u0026q=85\u0026s=3239fc52dcd6309d024795459614038d","dark":"https://mintcdn.com/heify/8fipfniSVMLrex-g/logo/dark.svg?fit=max\u0026auto=format\u0026n=8fipfniSVMLrex-g\u0026q=85\u0026s=28818c1e279567bb2c6104530b7ea8d0"},"favicon":"https://mintcdn.com/heify/SlX89gyPo8IeHqZ-/favicon.png?fit=max\u0026auto=format\u0026n=SlX89gyPo8IeHqZ-\u0026q=85\u0026s=a3cc859f6117001d46d83feb47c4ebbb","api":{"openapi":["api-reference/openapi-configurations.json","api-reference/openapi-transcriptions.json","api-reference/openapi-evaluators.json","api-reference/openapi-participants.json"],"playground":{"display":"interactive"},"mdx":{"auth":{"method":"key","name":"x-api-key"},"server":"https://api.heify.com"}},"navbar":{"links":[{"href":"https://www.heify.com/contact.html","label":"Contact"}],"primary":{"type":"button","label":"Get API Key","href":"https://sandbox.heify.com/sandbox/api-keys"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/heify"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Dashboard","icon":"chart-line","href":"https://sandbox.heify.com"},{"anchor":"Support","icon":"headset","href":"https://www.heify.com/contact.html"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"heify","hasAudioNarration":false,"actualSubdomain":"heify","customDomains":["docs.heify.com"],"gitSource":{"type":"github","owner":"pablosierrafernandez","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a858fff4866d053b8e4da71","collectionId":"ae164c56-04e8-4106-9ac6-49be695e58db","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6a858fff4866d053b8e4da71"},"entitlements":{},"buildId":"6a858fff4866d053b8e4da71:success","clientVersion":"0.0.4045","searchFilterCounts":[{"language":"default","tag":"API Reference","count":23},{"language":"default","tag":"Sandbox","count":11},{"language":"default","tag":"Documentation","count":10},{"language":"default","tag":"Transcriptions","count":8},{"language":"default","tag":"Configurations","count":6},{"language":"default","tag":"Evaluators","count":6},{"language":"default","tag":"Getting Started","count":6},{"language":"default","tag":"Modules","count":6},{"language":"default","tag":"Participants","count":5},{"language":"default","tag":"Core Objects","count":4}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/evaluator/create","slug":"/api-reference/evaluator/create","pageMetadata":{"title":"Create Evaluator","description":"Create a new evaluator with its evaluation criteria.","openapi":"api-reference/openapi-evaluators.json POST /create-evaluator","href":"/api-reference/evaluator/create"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Create a new evaluator with its evaluation criteria.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Note,Tip,Warning}=_components;if(!Note)_missingMdxReference(`Note`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Warning,{children:_jsxs(_components.p,{children:[`The sum of all non-`,_jsx(_components.code,{children:`strict`}),` criterion weights must equal `,_jsx(_components.strong,{children:`exactly 100`}),`. The weight of `,_jsx(_components.code,{children:`strict`}),` criteria is automatically set to `,_jsx(_components.code,{children:`0`}),` regardless of what you send.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`description`}),` of each criterion is the text the AI uses to evaluate the call. A clear, specific description directly improves evaluation accuracy. For guidance on writing effective criteria, see `,_jsx(_components.a,{href:`/core/evaluator#criteria`,children:`Evaluator — criteria`}),`.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`language`}),` defaults to `,_jsx(_components.code,{children:`\"df\"`}),` (auto-detect from audio). See `,_jsx(_components.a,{href:`/core/evaluator#language`,children:`Evaluator — language`}),` for supported language codes.`]})}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Maximum `,_jsx(_components.strong,{children:`20 evaluators`}),` per account and `,_jsx(_components.strong,{children:`10 criteria`}),` per evaluator. See `,_jsx(_components.a,{href:`/platform/rate-limits`,children:`Rate Limits \u0026 Quotas`}),`.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create Evaluator","description":"Create a new evaluator with its evaluation criteria.","openapi":"api-reference/openapi-evaluators.json POST /create-evaluator","href":"/api-reference/evaluator/create"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create Evaluator","description":"Create a new evaluator with its evaluation criteria.","requestBody":"73044ae2-ae8f-448b-ae9b-cad45f33f5a8","responses":{"201":"652d00a2-4e88-4e7a-b966-237f28b535b1"},"method":"post","type":"path","servers":["ad9f95e4-60ad-4a56-a6c4-5b363f271d09"],"security":["a1ae920a-335b-4948-b966-ac8fbfada121"],"path":"/create-evaluator","baseUrlOptions":["https://api.heify.com"],"title":"Create Evaluator","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tag":{"type":"string","description":"Name/label for the evaluator. Max 100 characters.","isRequired":true,"uniqueKey":"tag","typeLabel":"string"},"criteria":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":100,"description":"Name of the criterion. 1–100 characters.","isRequired":true,"uniqueKey":"criteria.items.[INDEX].name","typeLabel":"string"},"description":{"type":"string","minLength":5,"maxLength":2000,"description":"Detailed instructions for the AI on how to evaluate this criterion. 5–2000 characters. Quality of this description directly affects evaluation accuracy.","isRequired":true,"uniqueKey":"criteria.items.[INDEX].description","typeLabel":"string"},"type":{"type":"string","enum":["boolean","scale","strict"],"default":"boolean","description":"`boolean` — pass/fail (0% or 100%); `scale` — scored 1–5; `strict` — critical pass/fail that triggers a critical fail flag if failed, regardless of overall score.","uniqueKey":"criteria.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"weight":{"type":"integer","minimum":0,"maximum":100,"description":"Relative importance in the final score (0–100). Must be > 0 for non-`strict` criteria. Automatically forced to `0` for `strict` criteria.","uniqueKey":"criteria.items.[INDEX].weight","typeLabel":"integer"}},"required":["name","description"],"uniqueKey":"criteria.items.[INDEX]","typeLabel":"object"},"description":"List of evaluation criteria. Min 1, max 10 items. Non-`strict` weights must sum to exactly 100.","isRequired":true,"uniqueKey":"criteria","typeLabel":"object[]"},"description":{"oneOf":[{"type":"string","maxLength":250,"description":"Description of the evaluator's purpose. Max 250 characters.","uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":250,"description":"Description of the evaluator's purpose. Max 250 characters.","uniqueKey":"description.oneOf.1","typeLabel":"null"}],"uniqueKey":"description","typeLabel":"string | null"},"language":{"type":"string","default":"df","description":"Language for AI evaluation output. `\"df\"` (default) auto-detects from audio. See [Evaluator — language](/core/evaluator#language) for supported codes.","uniqueKey":"language","typeLabel":"string"},"context":{"oneOf":[{"type":"string","maxLength":1000,"description":"Additional context provided to the AI during evaluation. Helps the model understand the business scenario. Max 1000 characters.","uniqueKey":"context.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":1000,"description":"Additional context provided to the AI during evaluation. Helps the model understand the business scenario. Max 1000 characters.","uniqueKey":"context.oneOf.1","typeLabel":"null"}],"uniqueKey":"context","typeLabel":"string | null"}},"required":["tag","criteria"],"uniqueKey":"","typeLabel":"object"},"examples":{"CreateWithAllTypes":{"title":"CreateWithAllTypes","value":{"tag":"nombre de ejemplo","description":"descripcion opcional","language":"df","context":"You are evaluating a salesperson during a sales call or meeting with a prospect or client. Assess their ability to identify needs, communicate value and handle objections.","criteria":[{"name":"Cierre de Venta","description":"El agente debe solicitar explicitamente la venta o el compromiso del cliente utilizando tecnicas de cierre directas como \"¿Procedemos con la contratacion?\" o \"¿Le gustaria activar el servicio hoy?\". No debe finalizar la llamada sin haber intentado cerrar al menos una vez.","type":"boolean","weight":50},{"name":"Escucha Activa","description":"El agente no interrumpe al cliente mientras expone su problema, confirma los datos clave repitiendo o parafraseando lo escuchado y realiza preguntas relevantes para entender la situacion completa antes de ofrecer una solucion.","type":"strict","weight":0},{"name":"Empatia","description":"El agente muestra comprension ante la situacion del cliente utilizando frases de reconocimiento como \"Entiendo su frustracion\", \"Lamento las molestias\" o \"Comprendo lo importante que es esto para usted\". No debe minimizar el problema ni usar un tono condescendiente.","type":"scale","weight":50}]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"652d00a2-4e88-4e7a-b966-237f28b535b1":{"description":"Evaluator created successfully.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"message":{"type":"string","example":"Evaluator created successfully","uniqueKey":"data.message","typeLabel":"string"},"evaluator":{"type":"object","description":"Full evaluator object as returned by the API.","properties":{"evaluator_id":{"type":"string","format":"uuid","description":"Unique identifier for this evaluator.","uniqueKey":"data.evaluator.evaluator_id","typeLabel":"string\u003cuuid>"},"tag":{"type":"string","description":"Name/label for the evaluator (e.g. campaign name).","uniqueKey":"data.evaluator.tag","typeLabel":"string"},"description":{"oneOf":[{"type":"string","description":"Description of the evaluator's purpose.","uniqueKey":"data.evaluator.description.oneOf.0","typeLabel":"string"},{"type":"null","description":"Description of the evaluator's purpose.","uniqueKey":"data.evaluator.description.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.evaluator.description","typeLabel":"string | null"},"language":{"type":"string","description":"Language used for AI evaluation output. `\"df\"` = auto-detect from audio.","uniqueKey":"data.evaluator.language","typeLabel":"string"},"context":{"oneOf":[{"type":"string","description":"Additional context provided to the AI during evaluation.","uniqueKey":"data.evaluator.context.oneOf.0","typeLabel":"string"},{"type":"null","description":"Additional context provided to the AI during evaluation.","uniqueKey":"data.evaluator.context.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.evaluator.context","typeLabel":"string | null"},"criteria":{"type":"array","items":{"type":"object","description":"A criterion as returned in API responses. Identical to the input shape but includes an auto-generated `id`.","properties":{"id":{"type":"string","format":"uuid","description":"Auto-generated unique identifier for this criterion.","uniqueKey":"data.evaluator.criteria.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","description":"Name of the criterion.","uniqueKey":"data.evaluator.criteria.items.[INDEX].name","typeLabel":"string"},"description":{"type":"string","description":"Evaluation instructions provided to the AI.","uniqueKey":"data.evaluator.criteria.items.[INDEX].description","typeLabel":"string"},"type":{"type":"string","enum":["boolean","scale","strict"],"description":"Criterion evaluation type.","uniqueKey":"data.evaluator.criteria.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"weight":{"type":"integer","description":"Weight in the final score. Always `0` for `strict` criteria.","uniqueKey":"data.evaluator.criteria.items.[INDEX].weight","typeLabel":"integer"}},"uniqueKey":"data.evaluator.criteria.items.[INDEX]","typeLabel":"object"},"description":"Evaluation criteria for this evaluator.","uniqueKey":"data.evaluator.criteria","typeLabel":"object[]"},"created_at":{"type":"string","description":"Creation timestamp (ISO 8601).","uniqueKey":"data.evaluator.created_at","typeLabel":"string"}},"uniqueKey":"data.evaluator","typeLabel":"object"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Success":{"title":"Success","value":{"data":{"message":"Evaluator created successfully","evaluator":{"evaluator_id":"47e865ea-67ee-4930-9064-0a07db10c6b3","tag":"nombre de ejemplo","description":"descripcion opcional","language":"df","context":"You are evaluating a salesperson during a sales call or meeting with a prospect or client. Assess their ability to identify needs, communicate value and handle objections.","criteria":[{"id":"f5ccfa19-40d1-4d0c-aee5-4217a5a22485","name":"Cierre de Venta","description":"El agente debe solicitar explicitamente la venta...","type":"boolean","weight":50},{"id":"beaac9a5-a067-4413-9721-874e3ccda50c","name":"Escucha Activa","description":"El agente no interrumpe al cliente...","type":"strict","weight":0},{"id":"0daee516-3b0f-40b5-836e-f0850365d355","name":"Empatia","description":"El agente muestra comprension ante la situacion del cliente...","type":"scale","weight":50}],"created_at":"2026-03-21T14:19:57.834336+00:00"}}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"a1ae920a-335b-4948-b966-ac8fbfada121":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[]}}},"servers":{"ad9f95e4-60ad-4a56-a6c4-5b363f271d09":{"url":"https://api.heify.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[]},"schema":{"title":"x-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKeyAuth","name":"x-api-key"}],"title":"apiKeyAuth"}]},"originalFileLocation":"api-reference/openapi-evaluators.json"},"subdomain":"heify","siteName":"Heify Docs","title":"Create Evaluator - Heify Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-03-22T19:00:11.700Z","originalFileLocation":"api-reference/evaluator/create.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create a new evaluator with its evaluation criteria.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Heify Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/heify/L0uPIXNiZtcgAM5I/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/heify/L0uPIXNiZtcgAM5I/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/heify/L0uPIXNiZtcgAM5I/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/heify/L0uPIXNiZtcgAM5I/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/heify/L0uPIXNiZtcgAM5I/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/heify/L0uPIXNiZtcgAM5I/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/heify/L0uPIXNiZtcgAM5I/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/heify/L0uPIXNiZtcgAM5I/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/heify/L0uPIXNiZtcgAM5I/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Evaluator - Heify Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a new evaluator with its evaluation criteria.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Heify Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.heify.com/api-reference/evaluator/create\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://heify.mintlify.app/_mintlify/api/og/v2?division=Evaluators\u0026amp;title=Create+Evaluator\u0026amp;description=Create+a+new+evaluator+with+its+evaluation+criteria.\u0026amp;theme=10435d334a6726ab229dc0b4\u0026amp;signature=09c115da6c7561bc4c8073aee8b032a57708e8f2fe42dcd1ffb9d9a10be52725\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create Evaluator - Heify Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a new evaluator with its evaluation criteria.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://heify.mintlify.app/_mintlify/api/og/v2?division=Evaluators\u0026amp;title=Create+Evaluator\u0026amp;description=Create+a+new+evaluator+with+its+evaluation+criteria.\u0026amp;theme=10435d334a6726ab229dc0b4\u0026amp;signature=09c115da6c7561bc4c8073aee8b032a57708e8f2fe42dcd1ffb9d9a10be52725\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/heify/L0uPIXNiZtcgAM5I/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Heify Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3B82F6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.heify.com/api-reference/evaluator/create\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/evaluator/create.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.heify.com/#organization\",\"name\":\"Heify Docs\",\"url\":\"https://docs.heify.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/heify/8fipfniSVMLrex-g/logo/light.svg?fit=max\u0026auto=format\u0026n=8fipfniSVMLrex-g\u0026q=85\u0026s=3239fc52dcd6309d024795459614038d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.heify.com#website\",\"name\":\"Heify Docs\",\"url\":\"https://docs.heify.com\",\"publisher\":{\"@id\":\"https://docs.heify.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.heify.com/api-reference/evaluator/create#webpage\",\"url\":\"https://docs.heify.com/api-reference/evaluator/create\",\"name\":\"Create Evaluator\",\"description\":\"Create a new evaluator with its evaluation criteria.\",\"dateModified\":\"2026-03-22T19:00:11.700Z\",\"isPartOf\":{\"@id\":\"https://docs.heify.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.heify.com/api-reference/evaluator/create#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.heify.com/api-reference/evaluator/create#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Heify Docs\",\"item\":\"https://docs.heify.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create Evaluator\",\"item\":\"https://docs.heify.com/api-reference/evaluator/create\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.heify.com/api-reference/evaluator/create#apireference\",\"headline\":\"Create Evaluator\",\"name\":\"Create Evaluator\",\"description\":\"Create a new evaluator with its evaluation criteria.\",\"url\":\"https://docs.heify.com/api-reference/evaluator/create\",\"mainEntityOfPage\":{\"@id\":\"https://docs.heify.com/api-reference/evaluator/create#webpage\"},\"dateModified\":\"2026-03-22T19:00:11.700Z\",\"publisher\":{\"@id\":\"https://docs.heify.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.heify.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Heify Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Heify Docs","nav":{"global":{"anchors":[{"anchor":"Dashboard","icon":"chart-line","href":"https://sandbox.heify.com"},{"anchor":"Support","icon":"headset","href":"https://www.heify.com/contact.html"}]},"tabs":[{"tab":"Documentation","icon":"book","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","icon":"code","groups":[{"group":"Configurations","icon":"gear","pages":[{"title":"Create Configuration","openapi":"api-reference/openapi-configurations.json POST /create-configuration","href":"/api-reference/configuration/create"},{"title":"Get Configuration","openapi":"api-reference/openapi-configurations.json POST /get-configuration","href":"/api-reference/configuration/get"},{"title":"List Configurations","openapi":"api-reference/openapi-configurations.json POST /list-configurations","href":"/api-reference/configuration/list"},{"title":"Update Configuration","openapi":"api-reference/openapi-configurations.json POST /update-configuration","href":"/api-reference/configuration/update"},{"title":"Delete Configuration","openapi":"api-reference/openapi-configurations.json POST /delete-configuration","href":"/api-reference/configuration/delete"},{"title":"Configuration Analysis","description":"Generates an AI-powered analytics report for all completed transcriptions under a configuration.","openapi":"api-reference/openapi-configurations.json POST /analytics","href":"/api-reference/configuration/analytics"}]},{"group":"Evaluators","icon":"clipboard-check","pages":[{"title":"Create Evaluator","openapi":"api-reference/openapi-evaluators.json POST /create-evaluator","href":"/api-reference/evaluator/create"},{"title":"Get Evaluator","description":"Retrieve a single evaluator by ID.","openapi":"api-reference/openapi-evaluators.json POST /get-evaluator","href":"/api-reference/evaluator/get"},{"title":"List Evaluators","openapi":"api-reference/openapi-evaluators.json POST /list-evaluators","href":"/api-reference/evaluator/list"},{"title":"Update Evaluator","openapi":"api-reference/openapi-evaluators.json POST /update-evaluator","href":"/api-reference/evaluator/update"},{"title":"Delete Evaluator","openapi":"api-reference/openapi-evaluators.json POST /delete-evaluator","href":"/api-reference/evaluator/delete"},{"title":"Evaluator Analysis","openapi":"api-reference/openapi-evaluators.json POST /analytics-evaluator","href":"/api-reference/evaluator/analytics"}]},{"group":"Participants","icon":"user","pages":[{"title":"Create Participant","openapi":"api-reference/openapi-participants.json POST /create-participant","href":"/api-reference/participant/create"},{"title":"List Participants","openapi":"api-reference/openapi-participants.json POST /list-participants","href":"/api-reference/participant/list"},{"title":"Update Participant","openapi":"api-reference/openapi-participants.json POST /update-participant","href":"/api-reference/participant/update"},{"title":"Delete Participant","openapi":"api-reference/openapi-participants.json POST /delete-participant","href":"/api-reference/participant/delete"},{"title":"Participant Analysis","openapi":"api-reference/openapi-participants.json POST /analytics-participant","href":"/api-reference/participant/analytics"}]},{"group":"Transcriptions","icon":"microphone","pages":[{"title":"Submit from public URL","openapi":"api-reference/openapi-transcriptions.json POST /submit","href":"/api-reference/transcription/submit"},{"title":"Submit from local file","openapi":"api-reference/openapi-transcriptions.json POST /request-upload-url","href":"/api-reference/transcription/request-upload-url"},{"title":"Get Transcription","openapi":"api-reference/openapi-transcriptions.json POST /get-transcription","href":"/api-reference/transcription/details"},{"title":"List Transcriptions","openapi":"api-reference/openapi-transcriptions.json POST /list-transcriptions","href":"/api-reference/transcription/list"},{"title":"Update Transcription Group","openapi":"api-reference/openapi-transcriptions.json POST /update-transcription-group","href":"/api-reference/transcription/update-group"},{"title":"Delete Transcription","openapi":"api-reference/openapi-transcriptions.json POST /delete-transcription","href":"/api-reference/transcription/delete"}]}]},{"tab":"Sandbox","icon":"flask","pages":[{"title":"Sandbox","href":"/sandbox"}]},{"tab":"Recorder","icon":"circle-dot","pages":[{"title":"Recorder","href":"/recorder"}]}]},"basePath":"","title":"Create Evaluator - Heify Docs","buildId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","deploymentId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DCDCdBVX.js","utils-ME8dDnLe.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-0e84ACsd.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-wgRBj-ia.js","snippetPresets-C11Sgb-o.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-C0lapOpP.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-ZeRQV8fF.js","shallow-BupWh095.js","getApiPlaygroundDisplay-BnYQO2Ss.js","CodeSnippet-RKKOc8c_.js","CodeSnippets-Drf_m8wS.js","Page-Bevw23-4.js","getPastedJson-u6QiPzNZ.js","icon-Bb-CBSxO.js","MethodPill-F7l5AI7V.js","DuplicateIcon-IiAXkdSg.js","createIcon-FliI8EBc.js","DynamicMarkdown-B62XqCSI.js","SectionHeading-Dj31pT03.js","axios-vUo_bRtp.js","Markdown-BOgQCTwD.js","clsx-BIWXJmsZ.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DKZWslLH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-UDqbR6xh.js"]}