{
  "generated_from": "hookdeck/webhook-registry",
  "registry_commit": "a24c8d9784c9e9fe937c63f76adbce108201378f",
  "registry_committed_at": "2026-11-19T08:56:09Z",
  "disclaimer": "Independent reference. Not affiliated with GitLab.",
  "vendor": "gitlab",
  "name": "GitLab",
  "official_docs": "https://docs.gitlab.com/user/project/integrations/webhooks/",
  "docs_checked": "2026-10-18",
  "url": "https://hookdeck.com/webhooks/gitlab",
  "pages": [
    {
      "tab": "overview",
      "label": "Overview",
      "url": "https://hookdeck.com/webhooks/gitlab"
    },
    {
      "tab": "events",
      "label": "Webhook events",
      "url": "https://hookdeck.com/webhooks/gitlab/events"
    },
    {
      "tab": "mcp-events",
      "label": "MCP events",
      "url": "https://hookdeck.com/webhooks/gitlab/mcp-events"
    },
    {
      "tab": "verify",
      "label": "Verify signatures",
      "url": "https://hookdeck.com/webhooks/gitlab/verify"
    },
    {
      "tab": "guide",
      "label": "Production guide",
      "url": "https://hookdeck.com/webhooks/gitlab/guide-auto-disabling-duplicates-retries-timeouts"
    },
    {
      "tab": "skill",
      "label": "Agent skill",
      "url": "https://hookdeck.com/webhooks/gitlab/skill"
    }
  ],
  "summary": "GitLab signs some webhooks. Deliveries carry webhook-signature, webhook-id and webhook-timestamp (HMAC-SHA256). Deliveries can carry the legacy X-Gitlab-Token too.",
  "facts": [
    {
      "key": "signature_header",
      "label": "Signature header",
      "value": "webhook-signature",
      "detail": "Also sent: webhook-id, webhook-timestamp.",
      "source": {
        "kind": "vendor-docs",
        "label": "GitLab docs",
        "href": "https://docs.gitlab.com/user/project/integrations/webhooks/#signing-tokens"
      },
      "doc_discrepancy": null
    },
    {
      "key": "scheme",
      "label": "Scheme",
      "value": "HMAC-SHA256",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "GitLab docs",
        "href": "https://docs.gitlab.com/user/project/integrations/webhooks/#signing-tokens"
      },
      "doc_discrepancy": null
    },
    {
      "key": "signed_material",
      "label": "Signed material",
      "value": "{webhook-id}.{webhook-timestamp}.{raw body}",
      "detail": "The webhook-id header, a literal dot, the webhook-timestamp header, a literal dot, then the raw JSON body as sent. GitLab's docs write this as {message_id}.{timestamp}.{body}.",
      "source": {
        "kind": "vendor-docs",
        "label": "GitLab docs",
        "href": "https://docs.gitlab.com/user/project/integrations/webhooks/#signing-tokens"
      },
      "doc_discrepancy": null
    },
    {
      "key": "identified_by",
      "label": "How events are identified",
      "value": "x-gitlab-event header",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "GitLab docs",
        "href": "https://docs.gitlab.com/user/project/integrations/webhooks/#delivery-headers"
      },
      "doc_discrepancy": null
    },
    {
      "key": "body_format",
      "label": "Body format",
      "value": "JSON",
      "detail": "Content type: application/json.",
      "source": {
        "kind": "vendor-docs",
        "label": "GitLab docs",
        "href": "https://docs.gitlab.com/user/project/integrations/webhook_events/"
      },
      "doc_discrepancy": null
    },
    {
      "key": "timestamp",
      "label": "Send timestamp",
      "value": "webhook-timestamp",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "GitLab docs",
        "href": "https://docs.gitlab.com/user/project/integrations/webhooks/#signing-tokens"
      },
      "doc_discrepancy": null
    },
    {
      "key": "legacy_signature",
      "label": "Legacy signature",
      "value": "X-Gitlab-Token",
      "detail": "A secret token sent as plain text when one is configured, not a signature, so it doesn't protect the body.",
      "source": {
        "kind": "vendor-docs",
        "label": "GitLab docs",
        "href": "https://docs.gitlab.com/user/project/integrations/webhooks/#delivery-headers"
      },
      "doc_discrepancy": null
    },
    {
      "key": "other_headers",
      "label": "Other headers",
      "value": "x-gitlab-event, x-gitlab-event-uuid, x-gitlab-instance, x-gitlab-token, idempotency-key, x-gitlab-webhook-uuid",
      "detail": null,
      "source": {
        "kind": "registry",
        "label": "Registry record",
        "href": "https://hookdeck.com/webhooks/gitlab.json"
      },
      "doc_discrepancy": null
    },
    {
      "key": "agent_skill",
      "label": "Agent skill",
      "value": "npx skills add hookdeck/webhook-skills --skill gitlab-webhooks",
      "detail": null,
      "source": {
        "kind": "webhook-skills",
        "label": "Agent skill →",
        "href": "https://hookdeck.com/webhooks/gitlab/skill"
      },
      "doc_discrepancy": null
    }
  ],
  "not_yet_known": [],
  "enumeration": {
    "status": "partial",
    "reason": "This list covers project and group webhooks. System hooks, which administrators set up on self-managed and Dedicated instances, have their own events.",
    "source_url": "https://docs.gitlab.com/user/project/integrations/webhooks/",
    "checked": "2026-07-28"
  },
  "counts": {
    "events": 27,
    "with_payload": 26,
    "captured": 6,
    "with_description": 27,
    "resources": 6,
    "confidence": {
      "verified": 6,
      "documented": 21,
      "inferred": 0
    }
  },
  "mcp": {
    "native": "unknown",
    "checked": null,
    "via_hookdeck": "any GitLab event"
  },
  "events": [
    {
      "name": "push",
      "resource": "code",
      "description": "Commits pushed to a branch. Sent as Push Hook.",
      "confidence": "verified",
      "schema_source": "from a captured delivery",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/gitlab/events#push",
      "json": "https://hookdeck.com/webhooks/gitlab/events/push.json"
    },
    {
      "name": "tag_push",
      "resource": "code",
      "description": "Tag created or deleted. Sent as Tag Push Hook.",
      "confidence": "verified",
      "schema_source": "from a captured delivery",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/gitlab/events#tag_push",
      "json": "https://hookdeck.com/webhooks/gitlab/events/tag-push.json"
    },
    {
      "name": "issue",
      "resource": "collaboration",
      "description": "Issue opened, edited, closed or reopened. Sent as Issue Hook.",
      "confidence": "verified",
      "schema_source": "from a captured delivery",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/gitlab/events#issue",
      "json": "https://hookdeck.com/webhooks/gitlab/events/issue.json"
    },
    {
      "name": "work_item",
      "resource": "collaboration",
      "description": "Task, epic or other work item changes. Sent as Issue Hook.",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/gitlab/events#work_item",
      "json": "https://hookdeck.com/webhooks/gitlab/events/work-item.json"
    },
    {
      "name": "note",
      "resource": "collaboration",
      "description": "Comment added or edited. Sent as Note Hook.",
      "confidence": "verified",
      "schema_source": "from a captured delivery",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/gitlab/events#note",
      "json": "https://hookdeck.com/webhooks/gitlab/events/note.json"
    },
    {
      "name": "merge_request",
      "resource": "collaboration",
      "description": "Merge request opened, changed, merged or closed. Sent as Merge Request Hook.",
      "confidence": "documented",
      "schema_source": "from GitLab docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/gitlab/events#merge_request",
      "json": "https://hookdeck.com/webhooks/gitlab/events/merge-request.json"
    },
    {
      "name": "wiki_page",
      "resource": "collaboration",
      "description": "Wiki page created, edited or deleted. Sent as Wiki Page Hook.",
      "confidence": "verified",
      "schema_source": "from a captured delivery",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/gitlab/events#wiki_page",
      "json": "https://hookdeck.com/webhooks/gitlab/events/wiki-page.json"
    },
    {
      "name": "pipeline",
      "resource": "ci",
      "description": "Pipeline status changes. Sent as Pipeline Hook.",
      "confidence": "documented",
      "schema_source": "from GitLab docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/gitlab/events#pipeline",
      "json": "https://hookdeck.com/webhooks/gitlab/events/pipeline.json"
    },
    {
      "name": "build",
      "resource": "ci",
      "description": "CI job status changes. Sent as Job Hook.",
      "confidence": "documented",
      "schema_source": "from GitLab docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/gitlab/events#build",
      "json": "https://hookdeck.com/webhooks/gitlab/events/build.json"
    },
    {
      "name": "deployment",
      "resource": "ci",
      "description": "Deployment starts, ends, waits or is approved. Sent as Deployment Hook.",
      "confidence": "documented",
      "schema_source": "from GitLab docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/gitlab/events#deployment",
      "json": "https://hookdeck.com/webhooks/gitlab/events/deployment.json"
    },
    {
      "name": "user_add_to_group",
      "resource": "group",
      "description": "User added to a group. Sent as Member Hook.",
      "confidence": "documented",
      "schema_source": "from GitLab docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/gitlab/events#user_add_to_group",
      "json": "https://hookdeck.com/webhooks/gitlab/events/user-add-to-group.json"
    },
    {
      "name": "user_update_for_group",
      "resource": "group",
      "description": "Member's access level or expiry changes. Sent as Member Hook.",
      "confidence": "documented",
      "schema_source": "from GitLab docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/gitlab/events#user_update_for_group",
      "json": "https://hookdeck.com/webhooks/gitlab/events/user-update-for-group.json"
    },
    {
      "name": "user_remove_from_group",
      "resource": "group",
      "description": "User removed from a group. Sent as Member Hook.",
      "confidence": "documented",
      "schema_source": "from GitLab docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/gitlab/events#user_remove_from_group",
      "json": "https://hookdeck.com/webhooks/gitlab/events/user-remove-from-group.json"
    },
    {
      "name": "user_access_request_to_group",
      "resource": "group",
      "description": "User asks to join a group. Sent as Member Hook.",
      "confidence": "documented",
      "schema_source": "from GitLab docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/gitlab/events#user_access_request_to_group",
      "json": "https://hookdeck.com/webhooks/gitlab/events/user-access-request-to-group.json"
    },
    {
      "name": "user_access_request_denied_for_group",
      "resource": "group",
      "description": "Group access request denied. Sent as Member Hook.",
      "confidence": "documented",
      "schema_source": "from GitLab docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/gitlab/events#user_access_request_denied_for_group",
      "json": "https://hookdeck.com/webhooks/gitlab/events/user-access-request-denied-for-group.json"
    },
    {
      "name": "project_create",
      "resource": "group",
      "description": "Project created in a group. Sent as Project Hook.",
      "confidence": "documented",
      "schema_source": "from GitLab docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/gitlab/events#project_create",
      "json": "https://hookdeck.com/webhooks/gitlab/events/project-create.json"
    },
    {
      "name": "project_destroy",
      "resource": "group",
      "description": "Project deleted from a group. Sent as Project Hook.",
      "confidence": "documented",
      "schema_source": "from GitLab docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/gitlab/events#project_destroy",
      "json": "https://hookdeck.com/webhooks/gitlab/events/project-destroy.json"
    },
    {
      "name": "subgroup_create",
      "resource": "group",
      "description": "Subgroup created in a group. Sent as Subgroup Hook.",
      "confidence": "documented",
      "schema_source": "from GitLab docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/gitlab/events#subgroup_create",
      "json": "https://hookdeck.com/webhooks/gitlab/events/subgroup-create.json"
    },
    {
      "name": "subgroup_destroy",
      "resource": "group",
      "description": "Subgroup removed from a group. Sent as Subgroup Hook.",
      "confidence": "documented",
      "schema_source": "from GitLab docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/gitlab/events#subgroup_destroy",
      "json": "https://hookdeck.com/webhooks/gitlab/events/subgroup-destroy.json"
    },
    {
      "name": "feature_flag",
      "resource": "feature_flag",
      "description": "Feature flag turned on or off. Sent as Feature Flag Hook.",
      "confidence": "documented",
      "schema_source": "from GitLab docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/gitlab/events#feature_flag",
      "json": "https://hookdeck.com/webhooks/gitlab/events/feature-flag.json"
    },
    {
      "name": "release",
      "resource": "code",
      "description": "Release created, edited or deleted. Sent as Release Hook.",
      "confidence": "verified",
      "schema_source": "from a captured delivery",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/gitlab/events#release",
      "json": "https://hookdeck.com/webhooks/gitlab/events/release.json"
    },
    {
      "name": "milestone",
      "resource": "collaboration",
      "description": "Milestone created, closed, reopened or deleted. Sent as Milestone Hook.",
      "confidence": "documented",
      "schema_source": "from GitLab docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/gitlab/events#milestone",
      "json": "https://hookdeck.com/webhooks/gitlab/events/milestone.json"
    },
    {
      "name": "emoji",
      "resource": "collaboration",
      "description": "Emoji reaction added or removed. Sent as Emoji Hook.",
      "confidence": "documented",
      "schema_source": "from GitLab docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/gitlab/events#emoji",
      "json": "https://hookdeck.com/webhooks/gitlab/events/emoji.json"
    },
    {
      "name": "access_token",
      "resource": "security",
      "description": "Project or group access token nears expiry. Sent as Resource Access Token Hook.",
      "confidence": "documented",
      "schema_source": "from GitLab docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/gitlab/events#access_token",
      "json": "https://hookdeck.com/webhooks/gitlab/events/access-token.json"
    },
    {
      "name": "deploy_token",
      "resource": "security",
      "description": "Project or group deploy token nears expiry. Sent as Resource Deploy Token Hook.",
      "confidence": "documented",
      "schema_source": "from GitLab docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/gitlab/events#deploy_token",
      "json": "https://hookdeck.com/webhooks/gitlab/events/deploy-token.json"
    },
    {
      "name": "vulnerability",
      "resource": "security",
      "description": "Vulnerability created, status changed or issue linked. Sent as Vulnerability Hook.",
      "confidence": "documented",
      "schema_source": "from GitLab docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/gitlab/events#vulnerability",
      "json": "https://hookdeck.com/webhooks/gitlab/events/vulnerability.json"
    },
    {
      "name": "duo_workflow",
      "resource": "duo_workflow",
      "description": "Duo flow starts, progresses, finishes or fails. Sent as Duo Flow Callback.",
      "confidence": "documented",
      "schema_source": "from GitLab docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/gitlab/events#duo_workflow",
      "json": "https://hookdeck.com/webhooks/gitlab/events/duo-workflow.json"
    }
  ]
}