GitScrum / Docs

Setup Endpoints

Configure webhook endpoint URLs in GitScrum Project Settings. Manage event subscriptions, test endpoints, and monitor active webhooks.

Configure webhook endpoints in GitScrum to receive real-time notifications for project events. Each event type has its own endpoint URL, giving you granular control over which events go where.

Accessing Webhook Settings

  1. Open your project in GitScrum
  2. Click Settings in the project sidebar
  3. Select the Webhooks tab

The webhook configuration page displays a table of all available events organized by category.

Interface Overview

Header

The header shows:

  • Webhook Endpoints title
  • Loaded count — Total number of available webhook events
  • Active count — Number of events with configured endpoints
  • Test All button — Send test requests to all active webhooks

Event Table

Each row in the table contains:

ColumnDescription
StatusGreen dot = active, gray dot = inactive
EventEvent name and identifier
EndpointURL input field for the receiving server
ActionsTest (pulse icon) and Delete (X icon) buttons

Categories

Events are grouped into four expandable categories:

  • Tasks — Task creation, updates, moves, assignees, time tracking, comments, attachments, videos
  • User Stories — User story creation, updates, voting, deletion
  • Sprints — Sprint creation, updates, deletion
  • Others — Discussions voting

Click a category header to expand or collapse its events. The header shows active/total count (e.g., "3/12").

Adding an Endpoint

  1. Expand the category containing your target event
  2. Click the endpoint URL input field in the event row
  3. Enter a valid HTTP or HTTPS URL
  4. Press Enter or click outside the field
  5. The status indicator turns green on success

The endpoint is saved immediately via the API. No additional "Save" button is needed.

Removing an Endpoint

  1. Click the X icon in the Actions column
  2. The endpoint URL is cleared
  3. The status indicator turns gray
  4. No further events are sent to that endpoint

Testing Webhooks

Test a Single Endpoint

  1. Configure an endpoint URL for an event
  2. Click the test icon (pulse icon) in the Actions column
  3. A test payload is sent to your endpoint
  4. Check the status message below the input field

Test All Endpoints

Click the Test All button in the header to send test requests to every active webhook simultaneously. This verifies your entire configuration at once.

Using the Same URL for Multiple Events

You can configure the same endpoint URL for multiple events. Your server can differentiate events by examining the request payload, which includes the resource type.

To bulk-configure, enter the same URL in each event's endpoint field.

Permissions

Only users with Manager or Owner roles can configure webhooks. Other team members can view the webhook configuration but cannot modify endpoints.

Plan Requirements

Webhooks require a Pro plan or above. The webhook configuration interface is visible on all plans, but endpoint activation is gated behind the Pro feature.

Related