# GitLab webhook events

Every event here can also reach agents as an MCP event through Hookdeck: [MCP events](https://hookdeck.com/webhooks/gitlab/mcp-events).

Agent skill: `npx skills add hookdeck/webhook-skills --skill gitlab-webhooks` ([details](https://hookdeck.com/webhooks/gitlab/skill))

> Independent reference generated from hookdeck/webhook-registry (commit a24c8d9, 19 Nov 2026). [GitLab's official docs](https://docs.gitlab.com/user/project/integrations/webhooks/).

[Overview](https://hookdeck.com/webhooks/gitlab) · [Webhook events (27)](https://hookdeck.com/webhooks/gitlab/events) · [MCP events](https://hookdeck.com/webhooks/gitlab/mcp-events) · [Verify signatures](https://hookdeck.com/webhooks/gitlab/verify) · [Production guide](https://hookdeck.com/webhooks/gitlab/guide-auto-disabling-duplicates-retries-timeouts) · [Agent skill](https://hookdeck.com/webhooks/gitlab/skill)

## ci

### pipeline

Confidence: documented · Schema: from GitLab docs (example)

Pipeline status changes. Sent as Pipeline Hook.

Identified by: x-gitlab-event header · Object: `ci`

```json
{
  "object_kind": "pipeline",
  "object_attributes": { … },
  "merge_request": { … },
  "user": { … },
  "project": { … },
  "commit": { … },
  "builds": [ … ],
  "source_pipeline": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/gitlab/events/pipeline.json)

From GitLab docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/gitlab/events/pipeline.json)

### build

Confidence: documented · Schema: from GitLab docs (example)

CI job status changes. Sent as Job Hook.

Identified by: x-gitlab-event header · Object: `ci`

```json
{
  "object_kind": "build",
  "ref": "gitlab-script-trigger",
  "tag": false,
  "before_sha": "2293ada6b400935a1378653304eaf6221e0fdb8f",
  "sha": "2293ada6b400935a1378653304eaf6221e0fdb8f",
  "retries_count": 2,
  "build_id": 1977,
  "build_name": "test",
  "build_created_at": "2021-02-23T02:41:37.886Z"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/gitlab/events/build.json)

| Key field | Type | Example |
|---|---|---|
| `build_created_at` | string | `2021-02-23T02:41:37.886Z` |

From GitLab docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/gitlab/events/build.json)

### deployment

Confidence: documented · Schema: from GitLab docs (example)

Deployment starts, ends, waits or is approved. Sent as Deployment Hook.

Identified by: x-gitlab-event header · Object: `ci`

```json
{
  "object_kind": "deployment",
  "status": "success",
  "status_changed_at": "2021-04-28 21:50:00 +0200",
  "deployment_id": 15,
  "deployable_id": 796,
  "deployable_url": "http://10.126.0.2:3000/root/test-deployment-webhooks/-/jobs/796",
  "environment": "staging",
  "environment_tier": "staging",
  "environment_slug": "staging",
  "environment_external_url": "https://staging.example.com"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/gitlab/events/deployment.json)

| Key field | Type | Example |
|---|---|---|
| `status` | string | `success` |
| `status_changed_at` | string | `2021-04-28 21:50:00 +0200` |

From GitLab docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/gitlab/events/deployment.json)

## code

### push

Confidence: verified · Schema: from a captured delivery

Commits pushed to a branch. Sent as Push Hook.

Identified by: x-gitlab-event header · Object: `code`

```json
{
  "object_kind": "push",
  "event_name": "push",
  "before": "0000000000000000000000000000000000000000",
  "after": "6752dd8e9b70a034e36b495d26626dafef42c53c",
  "ref": "refs/heads/manage",
  "checkout_sha": "6752dd8e9b70a034e36b495d26626dafef42c53c",
  "message": null,
  "user_id": 10000001
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/gitlab/events/push.json)

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `content-type`, `x-gitlab-event`, `x-gitlab-event-uuid`, `x-gitlab-instance`, `x-gitlab-token`

[View as JSON](https://hookdeck.com/webhooks/gitlab/events/push.json)

### tag_push

Confidence: verified · Schema: from a captured delivery

Tag created or deleted. Sent as Tag Push Hook.

Identified by: x-gitlab-event header · Object: `code`

```json
{
  "object_kind": "tag_push",
  "event_name": "tag_push",
  "before": "0000000000000000000000000000000000000000",
  "after": "844cdc62966d4bf4b660285912fa530bf9c63257",
  "ref": "refs/tags/observe",
  "checkout_sha": "6752dd8e9b70a034e36b495d26626dafef42c53c",
  "message": "observing release",
  "user_id": 10000001
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/gitlab/events/tag-push.json)

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `content-type`, `x-gitlab-event`, `x-gitlab-event-uuid`, `x-gitlab-instance`, `x-gitlab-token`

[View as JSON](https://hookdeck.com/webhooks/gitlab/events/tag-push.json)

### release

Confidence: verified · Schema: from a captured delivery

Release created, edited or deleted. Sent as Release Hook.

Identified by: x-gitlab-event header · Object: `code`

```json
{
  "id": 7054492,
  "created_at": "2023-03-06 04:44:05 UTC",
  "description": "Leta see",
  "name": "os",
  "released_at": "2023-03-06 04:44:05 UTC",
  "tag": "observe",
  "object_kind": "release",
  "project": { … },
  "url": "https://gitlab.com/jane-doe/jane-doe/-/releases/observe",
  "action": "create"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/gitlab/events/release.json)

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `7054492` |
| `created_at` | string | `2023-03-06 04:44:05 UTC` |

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `content-type`, `x-gitlab-event`, `x-gitlab-event-uuid`, `x-gitlab-instance`, `x-gitlab-token`

[View as JSON](https://hookdeck.com/webhooks/gitlab/events/release.json)

## collaboration

### issue

Confidence: verified · Schema: from a captured delivery

Issue opened, edited, closed or reopened. Sent as Issue Hook.

Identified by: x-gitlab-event header · Object: `collaboration`

```json
{
  "object_kind": "issue",
  "event_type": "issue",
  "user": { … },
  "project": { … },
  "object_attributes": { … },
  "labels": [ … ],
  "changes": { … },
  "repository": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/gitlab/events/issue.json)

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `content-type`, `x-gitlab-event`, `x-gitlab-event-uuid`, `x-gitlab-instance`, `x-gitlab-token`

[View as JSON](https://hookdeck.com/webhooks/gitlab/events/issue.json)

### work_item

Confidence: documented · Schema: No payload yet

Task, epic or other work item changes. Sent as Issue Hook.

Identified by: x-gitlab-event header · Object: `collaboration`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/gitlab/events/work-item.json)

### note

Confidence: verified · Schema: from a captured delivery

Comment added or edited. Sent as Note Hook.

Identified by: x-gitlab-event header · Object: `collaboration`

```json
{
  "object_kind": "note",
  "event_type": "note",
  "user": { … },
  "project_id": 42958108,
  "project": { … },
  "object_attributes": { … },
  "repository": { … },
  "commit": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/gitlab/events/note.json)

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `content-type`, `x-gitlab-event`, `x-gitlab-event-uuid`, `x-gitlab-instance`, `x-gitlab-token`

[View as JSON](https://hookdeck.com/webhooks/gitlab/events/note.json)

### merge_request

Confidence: documented · Schema: from GitLab docs (example)

Merge request opened, changed, merged or closed. Sent as Merge Request Hook.

Identified by: x-gitlab-event header · Object: `collaboration`

```json
{
  "object_kind": "merge_request",
  "event_type": "merge_request",
  "user": { … },
  "project": { … },
  "object_attributes": { … },
  "labels": [ … ],
  "changes": { … },
  "assignees": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/gitlab/events/merge-request.json)

From GitLab docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/gitlab/events/merge-request.json)

### wiki_page

Confidence: verified · Schema: from a captured delivery

Wiki page created, edited or deleted. Sent as Wiki Page Hook.

Identified by: x-gitlab-event header · Object: `collaboration`

```json
{
  "object_kind": "wiki_page",
  "user": { … },
  "project": { … },
  "wiki": { … },
  "object_attributes": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/gitlab/events/wiki-page.json)

Seen in a captured delivery: content type `application/json` · headers `user-agent`, `content-type`, `x-gitlab-event`, `x-gitlab-event-uuid`, `x-gitlab-instance`, `x-gitlab-token`

[View as JSON](https://hookdeck.com/webhooks/gitlab/events/wiki-page.json)

### milestone

Confidence: documented · Schema: from GitLab docs (example)

Milestone created, closed, reopened or deleted. Sent as Milestone Hook.

Identified by: x-gitlab-event header · Object: `collaboration`

```json
{
  "object_kind": "milestone",
  "event_type": "milestone",
  "project": { … },
  "object_attributes": { … },
  "action": "create"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/gitlab/events/milestone.json)

From GitLab docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/gitlab/events/milestone.json)

### emoji

Confidence: documented · Schema: from GitLab docs (example)

Emoji reaction added or removed. Sent as Emoji Hook.

Identified by: x-gitlab-event header · Object: `collaboration`

```json
{
  "object_kind": "emoji",
  "event_type": "award",
  "user": { … },
  "project_id": 6,
  "project": { … },
  "object_attributes": { … },
  "note": { … },
  "issue": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/gitlab/events/emoji.json)

From GitLab docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/gitlab/events/emoji.json)

## group

### user_add_to_group

Confidence: documented · Schema: from GitLab docs (example)

User added to a group. Sent as Member Hook.

Identified by: x-gitlab-event header · Object: `group`

```json
{
  "created_at": "2020-12-11T04:57:22Z",
  "updated_at": "2020-12-11T04:57:22Z",
  "group_name": "webhook-test",
  "group_path": "webhook-test",
  "group_id": 100,
  "user_username": "test_user",
  "user_name": "Test User",
  "user_email": "testuser@webhooktest.com",
  "user_id": 64
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/gitlab/events/user-add-to-group.json)

| Key field | Type | Example |
|---|---|---|
| `created_at` | string | `2020-12-11T04:57:22Z` |

From GitLab docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/gitlab/events/user-add-to-group.json)

### user_update_for_group

Confidence: documented · Schema: from GitLab docs (example)

Member's access level or expiry changes. Sent as Member Hook.

Identified by: x-gitlab-event header · Object: `group`

```json
{
  "created_at": "2020-12-11T04:57:22Z",
  "updated_at": "2020-12-12T08:48:19Z",
  "group_name": "webhook-test",
  "group_path": "webhook-test",
  "group_id": 100,
  "user_username": "test_user",
  "user_name": "Test User",
  "user_email": "testuser@webhooktest.com",
  "user_id": 64
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/gitlab/events/user-update-for-group.json)

| Key field | Type | Example |
|---|---|---|
| `created_at` | string | `2020-12-11T04:57:22Z` |

From GitLab docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/gitlab/events/user-update-for-group.json)

### user_remove_from_group

Confidence: documented · Schema: from GitLab docs (example)

User removed from a group. Sent as Member Hook.

Identified by: x-gitlab-event header · Object: `group`

```json
{
  "created_at": "2020-12-11T04:57:22Z",
  "updated_at": "2020-12-12T08:52:34Z",
  "group_name": "webhook-test",
  "group_path": "webhook-test",
  "group_id": 100,
  "user_username": "test_user",
  "user_name": "Test User",
  "user_email": "testuser@webhooktest.com",
  "user_id": 64
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/gitlab/events/user-remove-from-group.json)

| Key field | Type | Example |
|---|---|---|
| `created_at` | string | `2020-12-11T04:57:22Z` |

From GitLab docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/gitlab/events/user-remove-from-group.json)

### user_access_request_to_group

Confidence: documented · Schema: from GitLab docs (example)

User asks to join a group. Sent as Member Hook.

Identified by: x-gitlab-event header · Object: `group`

```json
{
  "created_at": "2020-12-11T04:57:22Z",
  "updated_at": "2020-12-12T08:52:34Z",
  "group_name": "webhook-test",
  "group_path": "webhook-test",
  "group_id": 100,
  "user_username": "test_user",
  "user_name": "Test User",
  "user_email": "testuser@webhooktest.com",
  "user_id": 64
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/gitlab/events/user-access-request-to-group.json)

| Key field | Type | Example |
|---|---|---|
| `created_at` | string | `2020-12-11T04:57:22Z` |

From GitLab docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/gitlab/events/user-access-request-to-group.json)

### user_access_request_denied_for_group

Confidence: documented · Schema: from GitLab docs (example)

Group access request denied. Sent as Member Hook.

Identified by: x-gitlab-event header · Object: `group`

```json
{
  "created_at": "2020-12-11T04:57:22Z",
  "updated_at": "2020-12-12T08:52:34Z",
  "group_name": "webhook-test",
  "group_path": "webhook-test",
  "group_id": 100,
  "user_username": "test_user",
  "user_name": "Test User",
  "user_email": "testuser@webhooktest.com",
  "user_id": 64
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/gitlab/events/user-access-request-denied-for-group.json)

| Key field | Type | Example |
|---|---|---|
| `created_at` | string | `2020-12-11T04:57:22Z` |

From GitLab docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/gitlab/events/user-access-request-denied-for-group.json)

### project_create

Confidence: documented · Schema: from GitLab docs (example)

Project created in a group. Sent as Project Hook.

Identified by: x-gitlab-event header · Object: `group`

```json
{
  "event_name": "project_create",
  "created_at": "2024-10-07T10:43:48Z",
  "updated_at": "2024-10-07T10:43:48Z",
  "name": "project1",
  "path": "project1",
  "path_with_namespace": "group1/project1",
  "project_id": 22,
  "project_namespace_id": 32,
  "owners": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/gitlab/events/project-create.json)

| Key field | Type | Example |
|---|---|---|
| `created_at` | string | `2024-10-07T10:43:48Z` |

From GitLab docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/gitlab/events/project-create.json)

### project_destroy

Confidence: documented · Schema: from GitLab docs (example)

Project deleted from a group. Sent as Project Hook.

Identified by: x-gitlab-event header · Object: `group`

```json
{
  "event_name": "project_destroy",
  "created_at": "2024-10-07T10:43:48Z",
  "updated_at": "2024-10-07T10:43:48Z",
  "name": "project1",
  "path": "project1",
  "path_with_namespace": "group1/project1",
  "project_id": 22,
  "project_namespace_id": 32,
  "owners": [ … ]
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/gitlab/events/project-destroy.json)

| Key field | Type | Example |
|---|---|---|
| `created_at` | string | `2024-10-07T10:43:48Z` |

From GitLab docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/gitlab/events/project-destroy.json)

### subgroup_create

Confidence: documented · Schema: from GitLab docs (example)

Subgroup created in a group. Sent as Subgroup Hook.

Identified by: x-gitlab-event header · Object: `group`

```json
{
  "created_at": "2021-01-20T09:40:12Z",
  "updated_at": "2021-01-20T09:40:12Z",
  "event_name": "subgroup_create",
  "name": "subgroup1",
  "path": "subgroup1",
  "full_path": "group1/subgroup1",
  "group_id": 10,
  "parent_group_id": 7,
  "parent_name": "group1"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/gitlab/events/subgroup-create.json)

| Key field | Type | Example |
|---|---|---|
| `created_at` | string | `2021-01-20T09:40:12Z` |

From GitLab docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/gitlab/events/subgroup-create.json)

### subgroup_destroy

Confidence: documented · Schema: from GitLab docs (example)

Subgroup removed from a group. Sent as Subgroup Hook.

Identified by: x-gitlab-event header · Object: `group`

```json
{
  "created_at": "2021-01-20T09:40:12Z",
  "updated_at": "2021-01-20T09:40:12Z",
  "event_name": "subgroup_destroy",
  "name": "subgroup1",
  "path": "subgroup1",
  "full_path": "group1/subgroup1",
  "group_id": 10,
  "parent_group_id": 7,
  "parent_name": "group1"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/gitlab/events/subgroup-destroy.json)

| Key field | Type | Example |
|---|---|---|
| `created_at` | string | `2021-01-20T09:40:12Z` |

From GitLab docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/gitlab/events/subgroup-destroy.json)

## security

### access_token

Confidence: documented · Schema: from GitLab docs (example)

Project or group access token nears expiry. Sent as Resource Access Token Hook.

Identified by: x-gitlab-event header · Object: `security`

```json
{
  "object_kind": "access_token",
  "project": { … },
  "object_attributes": { … },
  "event_name": "expiring_access_token"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/gitlab/events/access-token.json)

From GitLab docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/gitlab/events/access-token.json)

### deploy_token

Confidence: documented · Schema: from GitLab docs (example)

Project or group deploy token nears expiry. Sent as Resource Deploy Token Hook.

Identified by: x-gitlab-event header · Object: `security`

```json
{
  "object_kind": "deploy_token",
  "project": { … },
  "object_attributes": { … },
  "event_name": "expiring_deploy_token"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/gitlab/events/deploy-token.json)

From GitLab docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/gitlab/events/deploy-token.json)

### vulnerability

Confidence: documented · Schema: from GitLab docs (example)

Vulnerability created, status changed or issue linked. Sent as Vulnerability Hook.

Identified by: x-gitlab-event header · Object: `security`

```json
{
  "object_kind": "vulnerability",
  "object_attributes": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/gitlab/events/vulnerability.json)

From GitLab docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/gitlab/events/vulnerability.json)

## Other GitLab events

### duo_workflow

Confidence: documented · Schema: from GitLab docs (example)

Duo flow starts, progresses, finishes or fails. Sent as Duo Flow Callback.

Identified by: x-gitlab-event header · Object: `duo_workflow`

```json
{
  "object_kind": "duo_workflow",
  "version": "1",
  "event": "flow.completed",
  "event_id": "f5e5f430-f57b-4e6e-9fac-d9128cd7232f",
  "client_reference": "run-abc123",
  "result": { … },
  "project": { … },
  "user": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/gitlab/events/duo-workflow.json)

From GitLab docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/gitlab/events/duo-workflow.json)

### feature_flag

Confidence: documented · Schema: from GitLab docs (example)

Feature flag turned on or off. Sent as Feature Flag Hook.

Identified by: x-gitlab-event header · Object: `feature_flag`

```json
{
  "object_kind": "feature_flag",
  "project": { … },
  "user": { … },
  "user_url": "http://example.com/root",
  "object_attributes": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/gitlab/events/feature-flag.json)

From GitLab docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/gitlab/events/feature-flag.json)

---

Not affiliated with GitLab. Facts are compiled from public sources and linked inline. [View as JSON](https://hookdeck.com/webhooks/gitlab.json) · [Report a correction](https://hookdeck.com/contact)
