---
title: "Service: /clients/{client}/webhooks [GET]"
source: https://dev.pageseeder.com/api/services/webhooks-GET.html
description: "API endpoint that retrieves webhooks for a specific OAuth client. Requires administrator access. Returns a list of webhook elements with associated client details in XML or JSON format. Returns 404 if client doesn't exist."
last_updated: 2026-09-02T11:36:02+10:00
document_type: api_endpoint
operation_id: webhook-GET
resource_id: webhook
path_template: /clients/{client}/webhooks
http_method: GET
api_category: webhook
implementation_version: 6.2004
api_since: 5.9500
deprecated_since: null
obsolete_since: null
api_support: experimental
cache_control: null
generated_at: 2026-09-02
tokens: ~751
---

# /clients/\{client\}/webhooks \[GET\]

## Description

Returns the list of [webhooks](../../reference/glossary/webhook.md) for a specific [OAuth client](../../reference/glossary/oauth_client.md).

> **Note:** Use the internal client id, not the [client ID](../../reference/glossary/client_id.md) in the URL. For example: `/clients/123/webhooks.json`

## Parameters

No parameters required.

## Permission

This service requires administrator.

## Response

A successful response return a list of [\<webhook\> elements](../elements/element_webhook.md). The client is returned within each webhook as a [\<client\> element](../elements/element_client.md).

### Sample XML

```xml
<webhooks>
  <webhook id="789" 
           created="2019-05-07T12:04:59+10:00"
           modified="2019-05-07T12:04:59+10:00" 
           url="https://ps.example.org/"
           server="false"
           object="minimal"
           format="xml"
           insecuressl="true"
           status="pending"
           name="Test"
           events="comment.*,group.*">
    <client id="123" 
            identifier="4739db31320c67c5" 
            requires-consent="false"
            confidential="false"
            name="sample"
            grant-type="password"
            created="2018-03-19T14:18:16+11:00"
            modified="2019-02-01T18:18:16+11:00"
            last-token="2022-07-06T17:00:00+10:00"
            description="Sample app"
            client-uri="https://app.example.org/"
            access-token-max-age="21600"
            refresh-token-max-age="2592000">
      <member id="456" status="activated"
              firstname="Joan" surname="Snow" username="jsnow">
        <fullname>Joan Snow</fullname>
      </member>
    </client>
  </webhook>
</webhooks>
```

### Sample JSON

```json
{
  "webhooks":[
    {
      "id": 789,
      "created": "2019-05-07T12:04:59+10:00",
      "modified": "2019-05-07T12:04:59+10:00",
      "url": "https://ps.example.org/",
      "server": false,
      "object": "minimal",
      "format": "xml",
      "insecuressl": true,
      "status": "pending",
      "name": "Test",
      "events": "comment.*,group.*",
      "client": {
        "id": 123,
        "identifier": "4739db31320c67c5",
        "requiresConsent": false,
        "confidential": false,
        "name": "Sample",
        "grantType": "password",
        "created": "2018-03-19T14:18:16+11:00",
        "modified": "2019-02-01T18:18:16+11:00",
        "lastToken": "2022-07-06T17:00:00+10:00",
        "description": "Sample app",
        "clientUri": "https://app.example.org/",
        "accessTokenMaxAge": 21600,
        "refreshTokenMaxAge": 2592000,
        "member": {
          "id": 456,
          "firstname": "Joan",
          "surname": "Snow",
          "username": "jsnow",
          "status": "activated",
          "fullname": "Joan Snow"
        }
      }
    }
  ]
}
```

## Error Handling

| HTTP code | Error condition |
| --- | --- |
| **404** | If the client does not exist. |