webhooks.xyz

Examples / Source control and developer tools / GitLab

GitLab webhooks

Pushes, merge requests, pipelines, issues, releases and deployments.

Events

  • Push Hook
  • Merge Request Hook
  • Pipeline Hook
  • Issue Hook
  • Deployment Hook

Signature

Header X-Gitlab-Token carries the secret token in plain text. Compare it with your stored value. X-Gitlab-Event names the event.

✓ A bin checks GitLab signatures: add the secret token under Signature verification (GitLab).

Retries

GitLab retries a failed delivery a few times with short gaps, then disables the hook after repeated failures.

See a retry schedule in the calculator.

Docs

docs.gitlab.com/user/project/integrations/webhooks/

Checked 2026-10-08. Report a change.

Sample request from GitLabillustrative, shortened
Content-Typeapplication/jsonX-Gitlab-EventPush HookX-Gitlab-Tokenyour-secret-tokenX-Gitlab-Instancehttps://gitlab.com 
{
  "object_kind": "push",
  "ref": "refs/heads/main",
  "user_username": "ravi",
  "project": { "id": 15, "path_with_namespace": "acme/shop-api" },
  "commits": [ { "id": "b2c3d4e5", "message": "Retry webhook deliveries with backoff", "author": { "name": "Ravi Kumar" } } ],
  "total_commits_count": 1
}

Receive GitLab webhooks with webhooks.xyz

Create a bin. Paste its URL into GitLab. Each request shows at once with its headers and body. Add your server as a destination, and deliveries retry when it is down. Request an invite.

More in source control and developer tools: Bitbucket Cloud, GitHub, Jira Cloud, Linear.