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 status changes. Sent as Pipeline Hook.

Identified by x-gitlab-event header Resource ci

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

From GitLab docs

  • Content type application/json

Send example to Inspect → View as JSON

build

documented from GitLab docs (example)

CI job status changes. Sent as Job Hook.

Identified by x-gitlab-event header Resource ci

gitlab-build.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"
}

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

Send example to Inspect → View as JSON

deployment

documented from GitLab docs (example)

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

Identified by x-gitlab-event header Resource ci

gitlab-deployment.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"
}

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

Send example to Inspect → View as JSON

code

push

verified from a captured delivery

Commits pushed to a branch. Sent as Push Hook.

Identified by x-gitlab-event header Resource code

gitlab-push.json
{
  "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

Send example to Inspect → View as JSON

tag_push

verified from a captured delivery

Tag created or deleted. Sent as Tag Push Hook.

Identified by x-gitlab-event header Resource code

gitlab-tag-push.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
}

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

Send example to Inspect → View as JSON

release

verified from a captured delivery

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

Identified by x-gitlab-event header Resource code

gitlab-release.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"
}

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

Send example to Inspect → View as JSON

collaboration

issue

verified from a captured delivery

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

Identified by x-gitlab-event header Resource collaboration

gitlab-issue.json
{
  "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

Send example to Inspect → View as JSON

work_item

documented No payload yet

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

Identified by x-gitlab-event header Resource collaboration

No payload yet.

Help fill this in → View as JSON

note

verified from a captured delivery

Comment added or edited. Sent as Note Hook.

Identified by x-gitlab-event header Resource collaboration

gitlab-note.json
{
  "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

Send example to Inspect → View as JSON

merge_request

documented from GitLab docs (example)

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

Identified by x-gitlab-event header Resource collaboration

gitlab-merge-request.json
{
  "object_kind": "merge_request",
  "event_type": "merge_request",
  "user": { … },
  "project": { … },
  "object_attributes": { … },
  "labels": [ … ],
  "changes": { … },
  "assignees": [ … ]
}

From GitLab docs

  • Content type application/json

Send example to Inspect → View as JSON

wiki_page

verified from a captured delivery

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

Identified by x-gitlab-event header Resource collaboration

gitlab-wiki-page.json
{
  "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

Send example to Inspect → View as JSON

milestone

documented from GitLab docs (example)

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

Identified by x-gitlab-event header Resource collaboration

gitlab-milestone.json
{
  "object_kind": "milestone",
  "event_type": "milestone",
  "project": { … },
  "object_attributes": { … },
  "action": "create"
}

From GitLab docs

  • Content type application/json

Send example to Inspect → View as JSON

emoji

documented from GitLab docs (example)

Emoji reaction added or removed. Sent as Emoji Hook.

Identified by x-gitlab-event header Resource collaboration

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

From GitLab docs

  • Content type application/json

Send example to Inspect → View as JSON

group

user_add_to_group

documented from GitLab docs (example)

User added to a group. Sent as Member Hook.

Identified by x-gitlab-event header Resource group

gitlab-user-add-to-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
}

Key fields

Field Type Example
created_at string 2020-12-11T04:57:22Z

Full schema: 13 fields.

From GitLab docs

  • Content type application/json

Send example to Inspect → View as JSON

user_update_for_group

documented from GitLab docs (example)

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

Identified by x-gitlab-event header Resource group

gitlab-user-update-for-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
}

Key fields

Field Type Example
created_at string 2020-12-11T04:57:22Z

Full schema: 13 fields.

From GitLab docs

  • Content type application/json

Send example to Inspect → View as JSON

user_remove_from_group

documented from GitLab docs (example)

User removed from a group. Sent as Member Hook.

Identified by x-gitlab-event header Resource group

gitlab-user-remove-from-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
}

Key fields

Field Type Example
created_at string 2020-12-11T04:57:22Z

Full schema: 13 fields.

From GitLab docs

  • Content type application/json

Send example to Inspect → View as JSON

user_access_request_to_group

documented from GitLab docs (example)

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

Identified by x-gitlab-event header Resource group

gitlab-user-access-request-to-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
}

Key fields

Field Type Example
created_at string 2020-12-11T04:57:22Z

Full schema: 13 fields.

From GitLab docs

  • Content type application/json

Send example to Inspect → View as JSON

user_access_request_denied_for_group

documented from GitLab docs (example)

Group access request denied. Sent as Member Hook.

Identified by x-gitlab-event header Resource group

gitlab-user-access-request-denied-for-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
}

Key fields

Field Type Example
created_at string 2020-12-11T04:57:22Z

Full schema: 13 fields.

From GitLab docs

  • Content type application/json

Send example to Inspect → View as JSON

project_create

documented from GitLab docs (example)

Project created in a group. Sent as Project Hook.

Identified by x-gitlab-event header Resource group

gitlab-project-create.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": [ … ]
}

Key fields

Field Type Example
created_at string 2024-10-07T10:43:48Z

Full schema: 13 fields.

From GitLab docs

  • Content type application/json

Send example to Inspect → View as JSON

project_destroy

documented from GitLab docs (example)

Project deleted from a group. Sent as Project Hook.

Identified by x-gitlab-event header Resource group

gitlab-project-destroy.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": [ … ]
}

Key fields

Field Type Example
created_at string 2024-10-07T10:43:48Z

Full schema: 13 fields.

From GitLab docs

  • Content type application/json

Send example to Inspect → View as JSON

subgroup_create

documented from GitLab docs (example)

Subgroup created in a group. Sent as Subgroup Hook.

Identified by x-gitlab-event header Resource group

gitlab-subgroup-create.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"
}

Key fields

Field Type Example
created_at string 2021-01-20T09:40:12Z

Full schema: 11 fields.

From GitLab docs

  • Content type application/json

Send example to Inspect → View as JSON

subgroup_destroy

documented from GitLab docs (example)

Subgroup removed from a group. Sent as Subgroup Hook.

Identified by x-gitlab-event header Resource group

gitlab-subgroup-destroy.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"
}

Key fields

Field Type Example
created_at string 2021-01-20T09:40:12Z

Full schema: 11 fields.

From GitLab docs

  • Content type application/json

Send example to Inspect → View as JSON

security

access_token

documented from GitLab docs (example)

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

Identified by x-gitlab-event header Resource security

gitlab-access-token.json
{
  "object_kind": "access_token",
  "project": { … },
  "object_attributes": { … },
  "event_name": "expiring_access_token"
}

From GitLab docs

  • Content type application/json

Send example to Inspect → View as JSON

deploy_token

documented from GitLab docs (example)

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

Identified by x-gitlab-event header Resource security

gitlab-deploy-token.json
{
  "object_kind": "deploy_token",
  "project": { … },
  "object_attributes": { … },
  "event_name": "expiring_deploy_token"
}

From GitLab docs

  • Content type application/json

Send example to Inspect → View as JSON

vulnerability

documented from GitLab docs (example)

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

Identified by x-gitlab-event header Resource security

gitlab-vulnerability.json
{
  "object_kind": "vulnerability",
  "object_attributes": { … }
}

From GitLab docs

  • Content type application/json

Send example to Inspect → View as JSON

Other GitLab events

duo_workflow

documented from GitLab docs (example)

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

Identified by x-gitlab-event header

gitlab-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": { … }
}

From GitLab docs

  • Content type application/json

Send example to Inspect → View as JSON

feature_flag

documented from GitLab docs (example)

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

Identified by x-gitlab-event header

gitlab-feature-flag.json
{
  "object_kind": "feature_flag",
  "project": { … },
  "user": { … },
  "user_url": "http://example.com/root",
  "object_attributes": { … }
}

From GitLab docs

  • Content type application/json

Send example to Inspect → View as 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.

Not affiliated with GitLab. Facts are compiled from public sources and linked inline.