List Endpoints
curl --request GET \
--url https://client-backend.oktivo.com/webhooks/endpoints \
--header 'Authorization: Bearer <token>'import requests
url = "https://client-backend.oktivo.com/webhooks/endpoints"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://client-backend.oktivo.com/webhooks/endpoints', 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://client-backend.oktivo.com/webhooks/endpoints",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://client-backend.oktivo.com/webhooks/endpoints"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://client-backend.oktivo.com/webhooks/endpoints")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://client-backend.oktivo.com/webhooks/endpoints")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": [
{
"webhookId": "wh_abc123def456",
"url": "https://your-app.com/webhooks/oktivo",
"eventTypes": ["call.ended", "call.analysis_ready"],
"description": "Salesforce integration",
"agentId": "agent_sales_qualifier",
"active": true,
"createdAt": "2025-01-10T12:00:00.000Z"
},
{
"webhookId": "wh_xyz789ghi012",
"url": "https://analytics.company.com/hooks/all-calls",
"eventTypes": ["call.completed"],
"description": "Analytics pipeline",
"agentId": null,
"active": true,
"createdAt": "2025-01-05T09:00:00.000Z"
}
]
}
Webhooks
List Endpoints
List all webhook endpoints.
GET
/
webhooks
/
endpoints
List Endpoints
curl --request GET \
--url https://client-backend.oktivo.com/webhooks/endpoints \
--header 'Authorization: Bearer <token>'import requests
url = "https://client-backend.oktivo.com/webhooks/endpoints"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://client-backend.oktivo.com/webhooks/endpoints', 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://client-backend.oktivo.com/webhooks/endpoints",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://client-backend.oktivo.com/webhooks/endpoints"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://client-backend.oktivo.com/webhooks/endpoints")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://client-backend.oktivo.com/webhooks/endpoints")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": [
{
"webhookId": "wh_abc123def456",
"url": "https://your-app.com/webhooks/oktivo",
"eventTypes": ["call.ended", "call.analysis_ready"],
"description": "Salesforce integration",
"agentId": "agent_sales_qualifier",
"active": true,
"createdAt": "2025-01-10T12:00:00.000Z"
},
{
"webhookId": "wh_xyz789ghi012",
"url": "https://analytics.company.com/hooks/all-calls",
"eventTypes": ["call.completed"],
"description": "Analytics pipeline",
"agentId": null,
"active": true,
"createdAt": "2025-01-05T09:00:00.000Z"
}
]
}
Response
Returns all webhook endpoints configured for your account.boolean
Indicates if the request was successful.
array
Array of webhook endpoint objects.
Show endpoint object properties
Show endpoint object properties
string
Unique identifier for the endpoint.
string
The delivery URL.
array
Event types this endpoint is subscribed to.
string | null
Human-readable description, if provided.
string | null
Agent filter, or
null if receiving events from all agents.boolean
Whether the endpoint is currently active and receiving events.
string
ISO 8601 timestamp of when the endpoint was created.
{
"success": true,
"data": [
{
"webhookId": "wh_abc123def456",
"url": "https://your-app.com/webhooks/oktivo",
"eventTypes": ["call.ended", "call.analysis_ready"],
"description": "Salesforce integration",
"agentId": "agent_sales_qualifier",
"active": true,
"createdAt": "2025-01-10T12:00:00.000Z"
},
{
"webhookId": "wh_xyz789ghi012",
"url": "https://analytics.company.com/hooks/all-calls",
"eventTypes": ["call.completed"],
"description": "Analytics pipeline",
"agentId": null,
"active": true,
"createdAt": "2025-01-05T09:00:00.000Z"
}
]
}
This endpoint requires JWT authentication. The webhook
secret is never returned in list responses.