webhook
/clients/{client}/webhooks/{webhook} [GET]
API Support | Available since | Last updated | Output |
---|---|---|---|
5.9500 | 6.1000 | xml, json |
Description
Returns information about the webhook on a specific client.
The {webhook}
URL parameter refers to the webhook ID.
Use the internal client id, not the client ID in the URL. For example: /clients/123/webhooks.json
Parameters
No parameters required.
Permission
This service requires administrator.
Response
A successful response returns the <webhook> element.
Sample XML
<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>
Sample JSON
{ "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 webhook does not exist |