generated: '2026-10-06'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://docs.gitlab.com/user/project/integrations/webhooks/
sources:
- https://docs.gitlab.com/user/project/integrations/webhooks/
- https://docs.gitlab.com/user/project/integrations/webhook_events/
- https://docs.gitlab.com/user/project/integrations/webhooks_troubleshooting/
- https://docs.gitlab.com/security/webhooks/
description: GitLab webhooks deliver HTTP POST requests for a defined set of project and group events.
events:
- event: Push event
  description: Triggered when a push is made to the repository.
- event: Tag event
  description: Triggered when tags are created or deleted in the repository.
- event: Comment event
  description: Triggered when a new comment is made or edited on commits, merge requests, issues, or code snippets.
- event: Deployment event
  description: Triggered when a deployment starts, finishes, fails, is canceled, or awaits approval or manual action.
- event: Emoji event
  description: Triggered when an emoji reaction is added or removed.
- event: Feature flag event
  description: Triggered when a feature flag is turned on or off.
- event: GitLab Duo flow event
  description: Triggered when a GitLab Duo flow that references the webhook starts, finishes, or fails.
- event: Job event
  description: Triggered when a job status changes.
- event: Merge request event
  description: Triggered when a merge request is created, edited, merged, closed, or when a commit is added to its source branch.
- event: Milestone event
  description: Triggered when a milestone is created, closed, reopened, or deleted.
- event: Pipeline event
  description: Triggered when a pipeline status changes.
- event: Project or group access token event
  description: Triggered when a project or group access token will expire in 7, 30, or 60 days.
- event: Release event
  description: Triggered when a release is created, edited, or deleted.
- event: Vulnerability event
  description: Triggered when a vulnerability is created or updated.
- event: Wiki page event
  description: Triggered when a wiki page is created, edited, or deleted.
- event: Work item event
  description: Triggered when a work item is created, edited, closed, or reopened.
- event: Group member event
  description: Triggered when a user is added or removed from a group, or a user's access level or expiration changes.
- event: Project event
  description: Triggered when a project is created or deleted within a group.
- event: Subgroup event
  description: Triggered when a subgroup is created or removed from a group.
delivery:
  signature: When a signing token is configured, GitLab includes a `webhook-signature` header containing an HMAC‑SHA256 signature (format `v1,{base64_signature}`)
    computed over `{message_id}.{timestamp}.{body}`.
  retries: The documentation does not specify a retry policy for webhook deliveries.
docs: https://docs.gitlab.com/user/project/integrations/webhooks/