List Webhooks - View Event Notification Endpoints

View all webhook endpoints configured for your subscription bot. Each webhook entry shows the destination URL and its unique secret for signature verification. Use this to audit your integrations and ensure events are being sent to the correct endpoints.

GET/v2/projects/{project_id}/integrations/webhooks

Authorization

Bearer TokenRequired

Path Parameters

project_idstringRequired

The unique identifier of the project.

Request

curl -X GET "https://api.botsubscription.com/v2/projects/YOUR_PROJECT_ID/integrations/webhooks" \
  -H "Authorization: Bearer YOUR_TOKEN"

const project_id = 'YOUR_PROJECT_ID';
const response = await fetch(`https://api.botsubscription.com/v2/projects/${project_id}/integrations/webhooks`, {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN'
  }
});
const data = await response.json();

import requests
 
project_id = 'YOUR_PROJECT_ID'
response = requests.get(
    f'https://api.botsubscription.com/v2/projects/{project_id}/integrations/webhooks',
    headers={'Authorization': 'Bearer YOUR_TOKEN'}
)
data = response.json()

$project_id = 'YOUR_PROJECT_ID';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.botsubscription.com/v2/projects/{$project_id}/integrations/webhooks");
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer YOUR_TOKEN']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

Successapplication/json

{
  "ok": true,
  "request_id": "11111111-1111-1111-1111-111111111111",
  "method": "GET",
  "path": "/v2/projects/YOUR_PROJECT_ID/integrations/webhooks",
  "code": 200,
  "total": 1,
  "message": "Webhooks retrieved successfully",
  "data": [
    {
      "url": "https://myapp.com/webhooks/botsubscription",
      "id": "22222222-2222-2222-2222-222222222222",
      "secret": "a1b2c3d4e5f6..."
    }
  ]
}

Last updated: January 25, 2026

API Endpoint

List Webhooks - View Event Notification Endpoints

Authorization

Path Parameters