curl --request POST \
--url https://api-prod.studio.getsupervisor.ai/v1/sip/trunks \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Twilio Production",
"carrierAddress": "my-trunk.pstn.twilio.com"
}
'{
"id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"workspaceId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"name": "Twilio Production",
"username": "ws_a1b2c3d4_8f3e1a2b",
"password": "kX9mP2vL8nQ4wR7j",
"domain": "sip.getsupervisor.ai",
"carrierAddress": "my-trunk.pstn.twilio.com",
"carrierPort": 5060,
"carrierTransport": "udp",
"phoneNumbers": [],
"status": "active",
"createdAt": "2026-01-15T10:30:00.000Z",
"updatedAt": "2026-01-15T10:30:00.000Z"
}{
"statusCode": 400,
"error": "Bad Request",
"message": [
"name must be longer than or equal to 1 characters"
]
}Crear un SIP trunk
Provisiona un nuevo SIP trunk generando automaticamente username y password. Crea el subscriber correspondiente en Kamailio con hashes HA1/HA1b para autenticacion digest.
Configurar en Retell AI -> Custom Telephony:
- Termination URI:
sip.getsupervisor.ai - SIP Trunk User Name: el
usernameretornado - SIP Trunk Password: el
passwordretornado
curl --request POST \
--url https://api-prod.studio.getsupervisor.ai/v1/sip/trunks \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Twilio Production",
"carrierAddress": "my-trunk.pstn.twilio.com"
}
'{
"id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"workspaceId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"name": "Twilio Production",
"username": "ws_a1b2c3d4_8f3e1a2b",
"password": "kX9mP2vL8nQ4wR7j",
"domain": "sip.getsupervisor.ai",
"carrierAddress": "my-trunk.pstn.twilio.com",
"carrierPort": 5060,
"carrierTransport": "udp",
"phoneNumbers": [],
"status": "active",
"createdAt": "2026-01-15T10:30:00.000Z",
"updatedAt": "2026-01-15T10:30:00.000Z"
}{
"statusCode": 400,
"error": "Bad Request",
"message": [
"name must be longer than or equal to 1 characters"
]
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Identificador del workspace multi-tenant. Obligatorio al autenticar con Authorization: Bearer, donde su ausencia devuelve 400 Workspace context is required. Con x-api-key es opcional: la llave ya identifica a su workspace y lo que mandes aquí se ignora.
Body
Datos para provisionar un nuevo SIP trunk. El workspaceId se obtiene del header x-workspace-id.
Nombre descriptivo del trunk.
1Hostname o IP del carrier PSTN.
1"my-trunk.pstn.twilio.com"
Puerto SIP del carrier.
x >= 1Protocolo de transporte SIP.
udp, tcp, tls Numeros de telefono asociados (E.164).
Response
Trunk creado con credenciales generadas
SIP trunk con el password visible. Solo se retorna al crear o regenerar password.
Identificador del workspace propietario del trunk.
Nombre descriptivo del trunk.
Username generado para autenticacion SIP digest.
Dominio SIP del gateway.
"sip.getsupervisor.ai"
Hostname o IP del carrier PSTN.
"my-trunk.pstn.twilio.com"
Puerto SIP del carrier.
Protocolo de transporte SIP.
udp, tcp, tls Numeros de telefono asociados al trunk (E.164).
Estado operativo del trunk.
active, inactive Password generado para autenticacion SIP digest. Solo visible en esta respuesta.