List webhook subscriptions
GET/api/public/webhooks
List webhook subscriptions for the current key's coach
Authentication
Requires an API key, sent as Authorization: Bearer cp_live_....
API keys carry scopes. Get the catalog of scopes and webhook events lists every scope.
Query parameters
| Name | Type | Description |
|---|---|---|
page | integer | Page number (1-based, default 1) |
limit | integer | Number of items to return (default 25, max 500) |
Request examples
curl --request GET \
--url 'https://api.coach-platform.com/api/public/webhooks' \
--header 'Authorization: Bearer cp_live_...'const response = await fetch('https://api.coach-platform.com/api/public/webhooks', {
method: 'GET',
headers: {
Authorization: 'Bearer cp_live_...',
},
});
const data = await response.json();Responses
200 OK
Successful response
{
"data": [
{
"id": "<string>",
"name": "<string>",
"url": "<string>",
"events": [
"<string>"
],
"active": true,
"includeCoachLoggedWorkouts": true,
"description": "<string>",
"failureCount": 123,
"createdAt": "<date-time>"
}
],
"pagination": {
"page": 123,
"limit": 123,
"total": 123,
"hasMore": true,
"truncated": true
}
}Response fields (16)
| Name | Type | Description |
|---|---|---|
data | object[] | |
data[].id | string | |
data[].name | string | |
data[].url | string | |
data[].events | string[] | |
data[].active | boolean | |
data[].includeCoachLoggedWorkouts | boolean | |
data[].description | string | |
data[].failureCount | number | |
data[].createdAt | string<date-time> | |
pagination | object | |
pagination.page | number | |
pagination.limit | number | |
pagination.total | number | null | Total number of matching items. null when the underlying source cannot report an exact count for this page; use hasMore to keep paging. |
pagination.hasMore | boolean | |
pagination.truncated | boolean | Present and true when the result set exceeded the in-memory scan cap and was truncated. Narrow your filters to page through all items. |
Error responses
400Bad Request401Unauthorized403Forbidden429Too Many Requests500Internal Server Error
These statuses share the same response body.
{
"error": {
"code": "<string>",
"message": "<string>",
"fix": "<string>",
"details": {},
"retryAfterMs": 123
}
}Error fields (6)
| Name | Type | Description |
|---|---|---|
error | object | |
error.code | string | |
error.message | string | |
error.fix | string | null | |
error.details | object | null | |
error.retryAfterMs | number | null |
This page is also available as Markdown. Browse it in the interactive explorer or download the OpenAPI spec.