GET /public/v1/webhooks

List outbound webhooks visible to the caller: their own PERSONAL webhooks plus every WORKSPACE-scoped one. Paused webhooks are included with isActive=false. Optionally scoped to one workspace.

GET /public/v1/webhooks

API key in header x-api-key

curl --request GET \
  --url 'https://api.joinvalley.co/public/v1/webhooks' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "statusCode": 1,
  "status": true,
  "message": "example",
  "data": {
    "webhooks": [
      {
        "id": "id_01JXY9AZK4KV",
        "label": "example",
        "scope": "PERSONAL",
        "webhookUrl": "https://example.com/webhook",
        "triggerTypes": [
          "example"
        ],
        "payloadFields": "example",
        "isActive": true,
        "createdByUserId": "created_by_user_01JXY9AZK4KV",
        "workspaceId": "workspace_01JXY9AZK4KV",
        "createdAt": "2026-01-01T12:00:00Z",
        "lastUsedAt": "2026-01-01T12:00:00Z"
      }
    ],
    "pagination": {
      "limit": 1,
      "offset": 1,
      "total": 1,
      "hasMore": true
    }
  }
}

Default Response

Query parameters

· 3

limit number · min: 1· max: 100· default: 20

offset number · min: 0· default: 0

workspaceId string

Restrict to one workspace (membership validated). A workspace API key is always locked to its own workspace.

Query parameters

Responses