RedRover Logo

Webhooks

List Webhook Endpoints

Lists the workspace's webhook endpoints, oldest first.

GET/webhooks
Scope: webhooks:read

Headers

  • AuthorizationstringRequired

    Bearer followed by an rr_live_ API key or a connected app's access token. See Authentication.

  • X-Workspace-IdstringRequired

    The workspace to act on, from List Workspaces.

    UUID

Response

200 Every endpoint in the workspace. Secrets are never returned.

  • dataobject[]Required
    Show 9 Child Fields
    • idstringRequired

      Webhook endpoint ID (UUID)

    • workspaceIdstringRequired

      The workspace whose events it gets

    • urlstringRequired

      Where we send events. Always https

    • descriptionstringRequired

      Your note about the endpoint

      nullable

    • eventsstring[]Required

      The events it subscribes to

      each one of post.scheduled, post.posted, post.failed, post.needs_approval, post.cancelled, comment.scheduled, comment.posted, comment.failed, comment.needs_approval, comment.cancelled, review.note_added

    • enabledbooleanRequired

      False when turned off, by you or after repeated failures

    • disabledReasonstringRequired

      Why we turned the endpoint off, when we did

      nullable

    • createdAtstringRequired

      ISO 8601 datetime

    • updatedAtstringRequired

      ISO 8601 datetime

Errors

Every error uses the error envelope.

  • 401The Authorization header is missing, or the key is invalid or revoked
  • 403The key lacks the endpoint's scope, or cannot reach the workspace
  • 429More than 120 requests in a minute. Wait for Retry-After seconds
  • 500Something went wrong on our side
curl "https://app.tryredrover.com/api/public/v1/webhooks" \
  -H "Authorization: Bearer $REDROVER_API_KEY" \
  -H "X-Workspace-Id: $REDROVER_WORKSPACE_ID"
200 Response
{
  "data": [
    {
      "id": "5d2f8a1c-4b6e-4f3a-9d7c-1e8b2a6f0c93",
      "workspaceId": "8f14e45f-ceea-4e1a-9c2b-6d7a1c3b9e21",
      "url": "https://example.com/hooks/redrover",
      "description": "Post updates to our team channel",
      "events": [
        "post.posted",
        "post.failed",
        "comment.posted"
      ],
      "enabled": true,
      "disabledReason": null,
      "createdAt": "2026-11-15T10:00:00Z",
      "updatedAt": "2026-11-15T10:00:00Z"
    }
  ]
}