GET /api/webhooks Bearer

List Webhooks

List all configured inbound webhook slots in PocketPaw. Each webhook has a unique ID, auto-generated secret for authentication, and a URL for receiving external payloads.

Overview

Returns all configured inbound webhook slots. Each webhook slot provides a unique URL and secret for receiving external payloads that are forwarded to the agent.

Response

webhooks array

Array of webhook slot objects.

name string
Webhook slot name (URL slug)
description string
Human-readable description
secret string
Webhook verification secret
url string
Full webhook URL

Terminal window
curl -X GET "http://localhost:8000/api/webhooks" \
  -H "Authorization: Bearer <token>"
const response = await fetch("http://localhost:8000/api/webhooks", {
  headers: { "Authorization": "Bearer <token>" }
});
const data = await response.json();
console.log(data);
import requests


response = requests.get(
    "http://localhost:8000/api/webhooks",
    headers={"Authorization": "Bearer <token>"}
)
print(response.json())
{
  "webhooks": [
    {
      "name": "github-events",
      "description": "GitHub repository webhooks",
      "secret": "whsec_a1b2c3d4e5f6...",
      "url": "http://localhost:8000/webhook/inbound/github-events"
    },
    {
      "name": "stripe-payments",
      "description": "Stripe payment notifications",
      "secret": "whsec_x7y8z9w0...",
      "url": "http://localhost:8000/webhook/inbound/stripe-payments"
    }
  ]
}
Request
curl -X GET "http://localhost:8000/api/webhooks" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>"
const response = await fetch("http://localhost:8000/api/webhooks", {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer <token>"
},
});

const data = await response.json();
console.log(data);
import requests

response = requests.get(
    "http://localhost:8000/api/webhooks",
    headers={'Content-Type':'application/json','Authorization':'Bearer <token>'},
)

print(response.json())
package main

import (
    "fmt"
    "net/http"
    "io"
)

func main() {
    req, _ := http.NewRequest("GET", "http://localhost:8000/api/webhooks", nil)
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("Authorization", "Bearer <token>")

    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}
Response
Send a request to see the response