Skip to main content
GET
/
organizations
/
{organizationId}
/
webhooks
List organization webhooks
curl --request GET \
  --url http://sandbox.mintlify.com/organizations/{organizationId}/webhooks \
  --header 'Authorization: Bearer <token>'
Lists all webhooks for an organization. Only OWNERS and ADMINS can view webhooks.

​
Authentication

This endpoint requires authentication via Bearer token:
  • Authorization: Bearer <token>

​
Path Parameters

ParameterTypeRequiredDescription
organizationIdstring (UUID)YesOrganization ID

​
Permissions

Only OWNERS and ADMINS can list webhooks.

​
Response

Returns an array of webhooks with:
  • Webhook ID, URL, and active status
  • Subscribed events
  • Creation and update timestamps
  • Signing secret for verification

​
Example Request

curl -X GET http://localhost:3001/api/organizations/550e8400-e29b-41d4-a716-446655440000/webhooks \
  -H "Authorization: Bearer <your_token>"

​
Example Response

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "organizationId": "550e8400-e29b-41d4-a716-446655440000",
    "url": "https://example.com/webhooks",
    "events": ["organization.created", "member.added"],
    "isActive": true,
    "createdAt": "2025-01-26T10:00:00Z",
    "updatedAt": "2025-01-26T10:00:00Z"
  }
]

​
Common Errors

​
401 Unauthorized

Authentication required. 
{
  "statusCode": 401,
  "message": "Authentication required. Provide a valid bearer token."
}

​
403 Forbidden

Only owners and admins can list webhooks. 
{
  "statusCode": 403,
  "message": "Access denied. Only owners and admins can list webhooks."
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
organizationId
string
required

Response

Webhooks retrieved successfully.