GitLab webhook events
27 GitLab event types in 5 resources, plus Other GitLab events. 26 have sample payloads.
Every event here can also reach agents as an MCP event through Hookdeck: MCP events →
ci
pipeline
documented from GitLab docs (example)
pipeline Pipeline status changes. Sent as Pipeline Hook.
Identified by x-gitlab-event header
Resource ci
{
"object_kind": "pipeline",
"object_attributes": { … },
"merge_request": { … },
"user": { … },
"project": { … },
"commit": { … },
"builds": [ … ],
"source_pipeline": { … }
} From GitLab docs
-
Content type
application/json
build
documented from GitLab docs (example)
build CI job status changes. Sent as Job Hook.
Identified by x-gitlab-event header
Resource ci
{
"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"
} Key fields
| Field | Type | Example |
|---|---|---|
build_created_at | string | 2021-02-23T02:41:37.886Z |
Full schema: 80 fields.
From GitLab docs
-
Content type
application/json
deployment
documented from GitLab docs (example)
deployment Deployment starts, ends, waits or is approved. Sent as Deployment Hook.
Identified by x-gitlab-event header
Resource ci
{
"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"
} Key fields
| Field | Type | Example |
|---|---|---|
status | string | success |
status_changed_at | string | 2021-04-28 21:50:00 +0200 |
Full schema: 37 fields.
From GitLab docs
-
Content type
application/json
code
push
verified from a captured delivery
push Commits pushed to a branch. Sent as Push Hook.
Identified by x-gitlab-event header
Resource code
{
"object_kind": "push",
"event_name": "push",
"before": "0000000000000000000000000000000000000000",
"after": "6752dd8e9b70a034e36b495d26626dafef42c53c",
"ref": "refs/heads/manage",
"checkout_sha": "6752dd8e9b70a034e36b495d26626dafef42c53c",
"message": null,
"user_id": 10000001
} 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
tag_push
verified from a captured delivery
tag_push Tag created or deleted. Sent as Tag Push Hook.
Identified by x-gitlab-event header
Resource code
{
"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
} 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
release
verified from a captured delivery
release Release created, edited or deleted. Sent as Release Hook.
Identified by x-gitlab-event header
Resource code
{
"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"
} Key fields
| Field | Type | Example |
|---|---|---|
id | integer | 7054492 |
created_at | string | 2023-03-06 04:44:05 UTC |
Full schema: 42 fields.
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
collaboration
issue
verified from a captured delivery
issue Issue opened, edited, closed or reopened. Sent as Issue Hook.
Identified by x-gitlab-event header
Resource collaboration
{
"object_kind": "issue",
"event_type": "issue",
"user": { … },
"project": { … },
"object_attributes": { … },
"labels": [ … ],
"changes": { … },
"repository": { … }
} 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
work_item
documented No payload yet
work_item Task, epic or other work item changes. Sent as Issue Hook.
Identified by x-gitlab-event header
Resource collaboration
No payload yet.
note
verified from a captured delivery
note Comment added or edited. Sent as Note Hook.
Identified by x-gitlab-event header
Resource collaboration
{
"object_kind": "note",
"event_type": "note",
"user": { … },
"project_id": 42958108,
"project": { … },
"object_attributes": { … },
"repository": { … },
"commit": { … }
} 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
merge_request
documented from GitLab docs (example)
merge_request Merge request opened, changed, merged or closed. Sent as Merge Request Hook.
Identified by x-gitlab-event header
Resource collaboration
{
"object_kind": "merge_request",
"event_type": "merge_request",
"user": { … },
"project": { … },
"object_attributes": { … },
"labels": [ … ],
"changes": { … },
"assignees": [ … ]
} From GitLab docs
-
Content type
application/json
wiki_page
verified from a captured delivery
wiki_page Wiki page created, edited or deleted. Sent as Wiki Page Hook.
Identified by x-gitlab-event header
Resource collaboration
{
"object_kind": "wiki_page",
"user": { … },
"project": { … },
"wiki": { … },
"object_attributes": { … }
} 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
milestone
documented from GitLab docs (example)
milestone Milestone created, closed, reopened or deleted. Sent as Milestone Hook.
Identified by x-gitlab-event header
Resource collaboration
{
"object_kind": "milestone",
"event_type": "milestone",
"project": { … },
"object_attributes": { … },
"action": "create"
} From GitLab docs
-
Content type
application/json
emoji
documented from GitLab docs (example)
emoji Emoji reaction added or removed. Sent as Emoji Hook.
Identified by x-gitlab-event header
Resource collaboration
{
"object_kind": "emoji",
"event_type": "award",
"user": { … },
"project_id": 6,
"project": { … },
"object_attributes": { … },
"note": { … },
"issue": { … }
} From GitLab docs
-
Content type
application/json
group
user_add_to_group
documented from GitLab docs (example)
user_add_to_group User added to a group. Sent as Member Hook.
Identified by x-gitlab-event header
Resource group
{
"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
} Key fields
| Field | Type | Example |
|---|---|---|
created_at | string | 2020-12-11T04:57:22Z |
Full schema: 13 fields.
From GitLab docs
-
Content type
application/json
user_update_for_group
documented from GitLab docs (example)
user_update_for_group Member's access level or expiry changes. Sent as Member Hook.
Identified by x-gitlab-event header
Resource group
{
"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
} Key fields
| Field | Type | Example |
|---|---|---|
created_at | string | 2020-12-11T04:57:22Z |
Full schema: 13 fields.
From GitLab docs
-
Content type
application/json
user_remove_from_group
documented from GitLab docs (example)
user_remove_from_group User removed from a group. Sent as Member Hook.
Identified by x-gitlab-event header
Resource group
{
"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
} Key fields
| Field | Type | Example |
|---|---|---|
created_at | string | 2020-12-11T04:57:22Z |
Full schema: 13 fields.
From GitLab docs
-
Content type
application/json
user_access_request_to_group
documented from GitLab docs (example)
user_access_request_to_group User asks to join a group. Sent as Member Hook.
Identified by x-gitlab-event header
Resource group
{
"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
} Key fields
| Field | Type | Example |
|---|---|---|
created_at | string | 2020-12-11T04:57:22Z |
Full schema: 13 fields.
From GitLab docs
-
Content type
application/json
user_access_request_denied_for_group
documented from GitLab docs (example)
user_access_request_denied_for_group Group access request denied. Sent as Member Hook.
Identified by x-gitlab-event header
Resource group
{
"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
} Key fields
| Field | Type | Example |
|---|---|---|
created_at | string | 2020-12-11T04:57:22Z |
Full schema: 13 fields.
From GitLab docs
-
Content type
application/json
project_create
documented from GitLab docs (example)
project_create Project created in a group. Sent as Project Hook.
Identified by x-gitlab-event header
Resource group
{
"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": [ … ]
} Key fields
| Field | Type | Example |
|---|---|---|
created_at | string | 2024-10-07T10:43:48Z |
Full schema: 13 fields.
From GitLab docs
-
Content type
application/json
project_destroy
documented from GitLab docs (example)
project_destroy Project deleted from a group. Sent as Project Hook.
Identified by x-gitlab-event header
Resource group
{
"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": [ … ]
} Key fields
| Field | Type | Example |
|---|---|---|
created_at | string | 2024-10-07T10:43:48Z |
Full schema: 13 fields.
From GitLab docs
-
Content type
application/json
subgroup_create
documented from GitLab docs (example)
subgroup_create Subgroup created in a group. Sent as Subgroup Hook.
Identified by x-gitlab-event header
Resource group
{
"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"
} Key fields
| Field | Type | Example |
|---|---|---|
created_at | string | 2021-01-20T09:40:12Z |
Full schema: 11 fields.
From GitLab docs
-
Content type
application/json
subgroup_destroy
documented from GitLab docs (example)
subgroup_destroy Subgroup removed from a group. Sent as Subgroup Hook.
Identified by x-gitlab-event header
Resource group
{
"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"
} Key fields
| Field | Type | Example |
|---|---|---|
created_at | string | 2021-01-20T09:40:12Z |
Full schema: 11 fields.
From GitLab docs
-
Content type
application/json
security
access_token
documented from GitLab docs (example)
access_token Project or group access token nears expiry. Sent as Resource Access Token Hook.
Identified by x-gitlab-event header
Resource security
{
"object_kind": "access_token",
"project": { … },
"object_attributes": { … },
"event_name": "expiring_access_token"
} From GitLab docs
-
Content type
application/json
deploy_token
documented from GitLab docs (example)
deploy_token Project or group deploy token nears expiry. Sent as Resource Deploy Token Hook.
Identified by x-gitlab-event header
Resource security
{
"object_kind": "deploy_token",
"project": { … },
"object_attributes": { … },
"event_name": "expiring_deploy_token"
} From GitLab docs
-
Content type
application/json
vulnerability
documented from GitLab docs (example)
vulnerability Vulnerability created, status changed or issue linked. Sent as Vulnerability Hook.
Identified by x-gitlab-event header
Resource security
{
"object_kind": "vulnerability",
"object_attributes": { … }
} From GitLab docs
-
Content type
application/json
Other GitLab events
duo_workflow
documented from GitLab docs (example)
duo_workflow Duo flow starts, progresses, finishes or fails. Sent as Duo Flow Callback.
Identified by x-gitlab-event header
{
"object_kind": "duo_workflow",
"version": "1",
"event": "flow.completed",
"event_id": "f5e5f430-f57b-4e6e-9fac-d9128cd7232f",
"client_reference": "run-abc123",
"result": { … },
"project": { … },
"user": { … }
} From GitLab docs
-
Content type
application/json
feature_flag
documented from GitLab docs (example)
feature_flag Feature flag turned on or off. Sent as Feature Flag Hook.
Identified by x-gitlab-event header
{
"object_kind": "feature_flag",
"project": { … },
"user": { … },
"user_url": "http://example.com/root",
"object_attributes": { … }
} From GitLab docs
-
Content type
application/json
Route GitLab events by type.
Event Gateway receives every GitLab delivery and filters and routes it by event type, so each service gets only the events it handles.