realaravinth/debian-mirror-gitlab
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
debian-mirror-gitlab/doc/user/project/integrations/webhooks.md

1819 lines
54 KiB
Markdown
Raw Normal View History

New upstream version 13.3.8
2020-10-24 23:57:45 +05:30
---
stage: Create
group: Ecosystem
New upstream version 13.7.7
2021-02-22 17:27:13 +05:30
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
New upstream version 13.3.8
2020-10-24 23:57:45 +05:30
---
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
New upstream version 13.10.3+ds1
2021-04-17 20:07:23 +05:30
# Webhooks **(FREE)**
New upstream version 11.2.8+dfsg
2018-11-18 11:00:15 +05:30
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
Project webhooks allow you to trigger a percent-encoded URL if, for example, new code is pushed or
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
a new issue is created. You can configure webhooks to listen for specific events
New upstream version 13.7.7
2021-02-22 17:27:13 +05:30
like pushes, issues or merge requests. GitLab sends a POST request with data
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
to the webhook URL.
New upstream version 13.7.7
2021-02-22 17:27:13 +05:30
You usually need to set up your own [webhook receiver](#example-webhook-receiver)
to receive information from GitLab and send it to another app, according to your requirements.
New upstream version 12.1.11
2019-09-30 21:07:59 +05:30
We already have a [built-in receiver](slack.md)
New upstream version 11.10.8+dfsg
2019-07-07 11:18:12 +05:30
for sending [Slack](https://api.slack.com/incoming-webhooks) notifications _per project_.
## Overview
[Webhooks](https://en.wikipedia.org/wiki/Webhook) are "_user-defined HTTP
callbacks_". They are usually triggered by some
event, such as pushing code to a repository or a comment being posted to a blog.
When that event occurs, the source app makes an HTTP request to the URI
configured for the webhook. The action taken may be anything.
Common uses are to trigger builds with continuous integration systems or to
notify bug tracking systems.
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
Webhooks can be used to update an external issue tracker, trigger CI jobs,
update a backup mirror, or even deploy to your production server.
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
Webhooks are available:
New upstream version 13.9.3+ds1
2021-03-11 19:13:27 +05:30
- Per project, at a project's **Settings > Webhooks** menu. **(FREE)**
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
- Additionally per group, at a group's **Settings > Webhooks** menu. **(PREMIUM)**
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
New upstream version 13.7.7
2021-02-22 17:27:13 +05:30
NOTE:
New upstream version 13.3.8
2020-10-24 23:57:45 +05:30
On GitLab.com, the [maximum number of webhooks and their size](../../../user/gitlab_com/index.md#webhooks) per project, and per group, is limited.
New upstream version 13.7.7
2021-02-22 17:27:13 +05:30
## Possible uses for webhooks
New upstream version 11.10.8+dfsg
2019-07-07 11:18:12 +05:30
- You can set up a webhook in GitLab to send a notification to
[Slack](https://api.slack.com/incoming-webhooks) every time a job fails.
- You can [integrate with Twilio to be notified via SMS](https://www.datadoghq.com/blog/send-alerts-sms-customizable-webhooks-twilio/)
every time an issue is created for a specific project or group within GitLab
New upstream version 12.4.6
2019-12-21 20:55:43 +05:30
- You can use them to [automatically assign labels to merge requests](https://about.gitlab.com/blog/2016/08/19/applying-gitlab-labels-automatically/).
New upstream version 11.10.8+dfsg
2019-07-07 11:18:12 +05:30
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
## Webhook endpoint tips
New upstream version 13.7.7
2021-02-22 17:27:13 +05:30
If you are writing your own endpoint (web server) to receive
GitLab webhooks, keep in mind the following:
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
New upstream version 13.7.7
2021-02-22 17:27:13 +05:30
- Your endpoint should send its HTTP response as fast as possible. If the response takes longer than
the configured timeout, GitLab decides the hook failed and retries it. For information on
customizing this timeout, see
[Webhook fails or multiple webhook requests are triggered](#webhook-fails-or-multiple-webhook-requests-are-triggered).
New upstream version 12.2.8
2019-10-12 21:52:04 +05:30
- Your endpoint should ALWAYS return a valid HTTP response. If you do
New upstream version 13.7.7
2021-02-22 17:27:13 +05:30
not do this then GitLab thinks the hook failed and retries it.
New upstream version 12.2.8
2019-10-12 21:52:04 +05:30
Most HTTP libraries take care of this for you automatically but if
you are writing a low-level hook this is important to remember.
- GitLab ignores the HTTP status code returned by your endpoint.
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
## Secret token
New upstream version 13.7.7
2021-02-22 17:27:13 +05:30
If you specify a secret token, it is sent with the hook request in the
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
`X-Gitlab-Token` HTTP header. Your webhook endpoint can check that to verify
that the request is legitimate.
## SSL verification
By default, the SSL certificate of the webhook endpoint is verified based on
New upstream version 13.7.7
2021-02-22 17:27:13 +05:30
an internal list of Certificate Authorities. This means the certificate cannot
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
be self-signed.
You can turn this off in the webhook settings in your GitLab projects.
New upstream version 11.3.10+dfsg
2018-11-20 20:47:30 +05:30
## Branch filtering
New upstream version 13.1.0
2020-06-23 00:09:42 +05:30
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/20338) in GitLab 11.3.
New upstream version 11.3.10+dfsg
2018-11-20 20:47:30 +05:30
Push events can be filtered by branch using a branch name or wildcard pattern
to limit which push events are sent to your webhook endpoint. By default the
field is blank causing all push events to be sent to your webhook endpoint.
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
## Events
Below are described the supported events.
### Push events
Triggered when you push to the repository except when pushing tags.
New upstream version 13.7.7
2021-02-22 17:27:13 +05:30
NOTE:
New upstream version 12.3.8
2019-12-04 20:38:33 +05:30
When more than 20 commits are pushed at once, the `commits` webhook
New upstream version 13.7.7
2021-02-22 17:27:13 +05:30
attribute only contains the first 20 for performance reasons. Loading
New upstream version 12.3.8
2019-12-04 20:38:33 +05:30
detailed commit data is expensive. Note that despite only 20 commits being
New upstream version 13.7.7
2021-02-22 17:27:13 +05:30
present in the `commits` attribute, the `total_commits_count` attribute contains the actual total.
New upstream version 10.5.5+dfsg
2018-03-17 18:26:18 +05:30
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
NOTE:
If a branch creation push event is generated without new commits being introduced, the
`commits` attribute in the payload is empty.
New upstream version 12.4.6
2019-12-21 20:55:43 +05:30
Also, if a single push includes changes for more than three (by default, depending on
New upstream version 13.7.7
2021-02-22 17:27:13 +05:30
[`push_event_hooks_limit` setting](../../../api/settings.md#list-of-settings-that-can-be-accessed-via-api-calls))
branches, this hook isn't executed.
New upstream version 12.4.6
2019-12-21 20:55:43 +05:30
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
**Request header**:
New upstream version 12.8.6
2020-03-13 15:44:24 +05:30
```plaintext
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
X-Gitlab-Event: Push Hook
```
**Request body:**
```json
{
"object_kind": "push",
"before": "95790bf891e76fee5e1747ab589903a6a1f80f22",
"after": "da1560886d4f094c3e6c9ef40349f7d38b5d27d7",
"ref": "refs/heads/master",
"checkout_sha": "da1560886d4f094c3e6c9ef40349f7d38b5d27d7",
"user_id": 4,
"user_name": "John Smith",
New upstream version 9.5.4+dfsg
2017-09-10 17:25:29 +05:30
"user_username": "jsmith",
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"user_email": "john@example.com",
"user_avatar": "https://s.gravatar.com/avatar/d4c74594d841139328695756648b6bd6?s=8://s.gravatar.com/avatar/d4c74594d841139328695756648b6bd6?s=80",
"project_id": 15,
"project":{
New upstream version 10.5.5+dfsg
2018-03-17 18:26:18 +05:30
"id": 15,
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"name":"Diaspora",
"description":"",
"web_url":"http://example.com/mike/diaspora",
"avatar_url":null,
"git_ssh_url":"git@example.com:mike/diaspora.git",
"git_http_url":"http://example.com/mike/diaspora.git",
"namespace":"Mike",
"visibility_level":0,
"path_with_namespace":"mike/diaspora",
"default_branch":"master",
"homepage":"http://example.com/mike/diaspora",
"url":"git@example.com:mike/diaspora.git",
"ssh_url":"git@example.com:mike/diaspora.git",
"http_url":"http://example.com/mike/diaspora.git"
},
"repository":{
"name": "Diaspora",
"url": "git@example.com:mike/diaspora.git",
"description": "",
"homepage": "http://example.com/mike/diaspora",
"git_http_url":"http://example.com/mike/diaspora.git",
"git_ssh_url":"git@example.com:mike/diaspora.git",
"visibility_level":0
},
"commits": [
{
"id": "b6568db1bc1dcd7f8b4d5a946b0b91f9dacd7327",
New upstream version 12.9.2
2020-04-08 14:13:33 +05:30
"message": "Update Catalan translation to e38cb41.\n\nSee https://gitlab.com/gitlab-org/gitlab for more information",
"title": "Update Catalan translation to e38cb41.",
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"timestamp": "2011-12-12T14:27:31+02:00",
"url": "http://example.com/mike/diaspora/commit/b6568db1bc1dcd7f8b4d5a946b0b91f9dacd7327",
"author": {
"name": "Jordi Mallach",
"email": "jordi@softcatala.org"
},
"added": ["CHANGELOG"],
"modified": ["app/controller/application.rb"],
"removed": []
},
{
"id": "da1560886d4f094c3e6c9ef40349f7d38b5d27d7",
"message": "fixed readme",
New upstream version 12.9.2
2020-04-08 14:13:33 +05:30
"title": "fixed readme",
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"timestamp": "2012-01-03T23:36:29+02:00",
"url": "http://example.com/mike/diaspora/commit/da1560886d4f094c3e6c9ef40349f7d38b5d27d7",
"author": {
"name": "GitLab dev user",
"email": "gitlabdev@dv6700.(none)"
},
"added": ["CHANGELOG"],
"modified": ["app/controller/application.rb"],
"removed": []
}
],
"total_commits_count": 4
}
```
### Tag events
Triggered when you create (or delete) tags to the repository.
New upstream version 13.7.7
2021-02-22 17:27:13 +05:30
NOTE:
New upstream version 12.4.6
2019-12-21 20:55:43 +05:30
If a single push includes changes for more than three (by default, depending on
New upstream version 13.7.7
2021-02-22 17:27:13 +05:30
[`push_event_hooks_limit` setting](../../../api/settings.md#list-of-settings-that-can-be-accessed-via-api-calls))
tags, this hook is not executed.
New upstream version 12.4.6
2019-12-21 20:55:43 +05:30
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
**Request header**:
New upstream version 12.8.6
2020-03-13 15:44:24 +05:30
```plaintext
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
X-Gitlab-Event: Tag Push Hook
```
**Request body:**
```json
{
"object_kind": "tag_push",
"before": "0000000000000000000000000000000000000000",
"after": "82b3d5ae55f7080f1e6022629cdb57bfae7cccc7",
"ref": "refs/tags/v1.0.0",
"checkout_sha": "82b3d5ae55f7080f1e6022629cdb57bfae7cccc7",
"user_id": 1,
"user_name": "John Smith",
"user_avatar": "https://s.gravatar.com/avatar/d4c74594d841139328695756648b6bd6?s=8://s.gravatar.com/avatar/d4c74594d841139328695756648b6bd6?s=80",
"project_id": 1,
"project":{
New upstream version 10.5.5+dfsg
2018-03-17 18:26:18 +05:30
"id": 1,
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"name":"Example",
"description":"",
"web_url":"http://example.com/jsmith/example",
"avatar_url":null,
"git_ssh_url":"git@example.com:jsmith/example.git",
"git_http_url":"http://example.com/jsmith/example.git",
"namespace":"Jsmith",
"visibility_level":0,
"path_with_namespace":"jsmith/example",
"default_branch":"master",
"homepage":"http://example.com/jsmith/example",
"url":"git@example.com:jsmith/example.git",
"ssh_url":"git@example.com:jsmith/example.git",
"http_url":"http://example.com/jsmith/example.git"
},
"repository":{
"name": "Example",
"url": "ssh://git@example.com/jsmith/example.git",
"description": "",
"homepage": "http://example.com/jsmith/example",
"git_http_url":"http://example.com/jsmith/example.git",
"git_ssh_url":"git@example.com:jsmith/example.git",
"visibility_level":0
},
"commits": [],
"total_commits_count": 0
}
```
New upstream version 12.10.0
2020-04-22 19:07:51 +05:30
### Issue events
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
Triggered when a new issue is created or an existing issue was updated/closed/reopened.
**Request header**:
New upstream version 12.8.6
2020-03-13 15:44:24 +05:30
```plaintext
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
X-Gitlab-Event: Issue Hook
```
**Request body:**
```json
{
"object_kind": "issue",
New upstream version 12.10.0
2020-04-22 19:07:51 +05:30
"event_type": "issue",
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"user": {
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
"id": 1,
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"name": "Administrator",
"username": "root",
New upstream version 12.10.0
2020-04-22 19:07:51 +05:30
"avatar_url": "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=40\u0026d=identicon",
"email": "admin@example.com"
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
},
New upstream version 10.5.5+dfsg
2018-03-17 18:26:18 +05:30
"project": {
"id": 1,
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"name":"Gitlab Test",
"description":"Aut reprehenderit ut est.",
"web_url":"http://example.com/gitlabhq/gitlab-test",
"avatar_url":null,
"git_ssh_url":"git@example.com:gitlabhq/gitlab-test.git",
"git_http_url":"http://example.com/gitlabhq/gitlab-test.git",
"namespace":"GitlabHQ",
"visibility_level":20,
"path_with_namespace":"gitlabhq/gitlab-test",
"default_branch":"master",
New upstream version 12.10.0
2020-04-22 19:07:51 +05:30
"ci_config_path": null,
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"homepage":"http://example.com/gitlabhq/gitlab-test",
"url":"http://example.com/gitlabhq/gitlab-test.git",
"ssh_url":"git@example.com:gitlabhq/gitlab-test.git",
"http_url":"http://example.com/gitlabhq/gitlab-test.git"
},
"object_attributes": {
"id": 301,
"title": "New API: create/update/delete file",
"assignee_ids": [51],
"assignee_id": 51,
"author_id": 51,
"project_id": 14,
"created_at": "2013-12-03T17:15:43Z",
"updated_at": "2013-12-03T17:15:43Z",
New upstream version 12.10.0
2020-04-22 19:07:51 +05:30
"updated_by_id": 1,
"last_edited_at": null,
"last_edited_by_id": null,
"relative_position": 0,
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"description": "Create new API for manipulations with repository",
"milestone_id": null,
New upstream version 12.10.0
2020-04-22 19:07:51 +05:30
"state_id": 1,
"confidential": false,
"discussion_locked": true,
"due_date": null,
"moved_to_id": null,
"duplicated_to_id": null,
"time_estimate": 0,
"total_time_spent": 0,
"human_total_time_spent": null,
"human_time_estimate": null,
"weight": null,
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"iid": 23,
"url": "http://example.com/diaspora/issues/23",
New upstream version 12.10.0
2020-04-22 19:07:51 +05:30
"state": "opened",
"action": "open",
"labels": [{
"id": 206,
"title": "API",
"color": "#ffffff",
"project_id": 14,
"created_at": "2013-12-03T17:15:43Z",
"updated_at": "2013-12-03T17:15:43Z",
"template": false,
"description": "API related issues",
"type": "ProjectLabel",
"group_id": 41
}]
},
"repository": {
"name": "Gitlab Test",
"url": "http://example.com/gitlabhq/gitlab-test.git",
"description": "Aut reprehenderit ut est.",
"homepage": "http://example.com/gitlabhq/gitlab-test"
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
},
"assignees": [{
"name": "User1",
"username": "user1",
"avatar_url": "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=40\u0026d=identicon"
}],
"assignee": {
"name": "User1",
"username": "user1",
"avatar_url": "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=40\u0026d=identicon"
},
"labels": [{
"id": 206,
"title": "API",
"color": "#ffffff",
"project_id": 14,
"created_at": "2013-12-03T17:15:43Z",
"updated_at": "2013-12-03T17:15:43Z",
"template": false,
"description": "API related issues",
"type": "ProjectLabel",
"group_id": 41
New upstream version 10.5.5+dfsg
2018-03-17 18:26:18 +05:30
}],
"changes": {
New upstream version 12.0.8
2019-09-04 21:01:54 +05:30
"updated_by_id": {
"previous": null,
"current": 1
},
"updated_at": {
New upstream version 12.1.11
2019-09-30 21:07:59 +05:30
"previous": "2017-09-15 16:50:55 UTC",
New upstream version 12.0.8
2019-09-04 21:01:54 +05:30
"current": "2017-09-15 16:52:00 UTC"
},
New upstream version 10.5.5+dfsg
2018-03-17 18:26:18 +05:30
"labels": {
"previous": [{
"id": 206,
"title": "API",
"color": "#ffffff",
"project_id": 14,
"created_at": "2013-12-03T17:15:43Z",
"updated_at": "2013-12-03T17:15:43Z",
"template": false,
"description": "API related issues",
"type": "ProjectLabel",
"group_id": 41
}],
"current": [{
"id": 205,
"title": "Platform",
"color": "#123123",
"project_id": 14,
"created_at": "2013-12-03T17:15:43Z",
"updated_at": "2013-12-03T17:15:43Z",
"template": false,
"description": "Platform related issues",
"type": "ProjectLabel",
"group_id": 41
}]
}
}
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
}
```
New upstream version 13.7.7
2021-02-22 17:27:13 +05:30
NOTE:
`assignee` and `assignee_id` keys are deprecated and now show the first assignee only.
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
### Comment events
Triggered when a new comment is made on commits, merge requests, issues, and code snippets.
New upstream version 13.7.7
2021-02-22 17:27:13 +05:30
The note data is stored in `object_attributes` (for example, `note` or `noteable_type`). The
payload also includes information about the target of the comment. For example,
a comment on an issue includes the specific issue information under the `issue` key.
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
Valid target types:
New upstream version 11.7.5
2019-02-15 15:39:39 +05:30
- `commit`
- `merge_request`
- `issue`
- `snippet`
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
#### Comment on commit
**Request header**:
New upstream version 12.8.6
2020-03-13 15:44:24 +05:30
```plaintext
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
X-Gitlab-Event: Note Hook
```
**Request body:**
```json
{
"object_kind": "note",
"user": {
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
"id": 1,
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"name": "Administrator",
"username": "root",
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
"avatar_url": "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=40\u0026d=identicon",
"email": "admin@example.com"
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
},
"project_id": 5,
"project":{
New upstream version 10.5.5+dfsg
2018-03-17 18:26:18 +05:30
"id": 5,
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"name":"Gitlab Test",
"description":"Aut reprehenderit ut est.",
"web_url":"http://example.com/gitlabhq/gitlab-test",
"avatar_url":null,
"git_ssh_url":"git@example.com:gitlabhq/gitlab-test.git",
"git_http_url":"http://example.com/gitlabhq/gitlab-test.git",
"namespace":"GitlabHQ",
"visibility_level":20,
"path_with_namespace":"gitlabhq/gitlab-test",
"default_branch":"master",
"homepage":"http://example.com/gitlabhq/gitlab-test",
"url":"http://example.com/gitlabhq/gitlab-test.git",
"ssh_url":"git@example.com:gitlabhq/gitlab-test.git",
"http_url":"http://example.com/gitlabhq/gitlab-test.git"
},
"repository":{
"name": "Gitlab Test",
"url": "http://example.com/gitlab-org/gitlab-test.git",
"description": "Aut reprehenderit ut est.",
"homepage": "http://example.com/gitlab-org/gitlab-test"
},
"object_attributes": {
"id": 1243,
"note": "This is a commit comment. How does this work?",
"noteable_type": "Commit",
"author_id": 1,
"created_at": "2015-05-17 18:08:09 UTC",
"updated_at": "2015-05-17 18:08:09 UTC",
"project_id": 5,
"attachment":null,
"line_code": "bec9703f7a456cd2b4ab5fb3220ae016e3e394e3_0_1",
"commit_id": "cfe32cf61b73a0d5e9f13e774abde7ff789b1660",
"noteable_id": null,
"system": false,
"st_diff": {
"diff": "--- /dev/null\n+++ b/six\n@@ -0,0 +1 @@\n+Subproject commit 409f37c4f05865e4fb208c771485f211a22c4c2d\n",
"new_path": "six",
"old_path": "six",
"a_mode": "0",
"b_mode": "160000",
"new_file": true,
"renamed_file": false,
"deleted_file": false
},
"url": "http://example.com/gitlab-org/gitlab-test/commit/cfe32cf61b73a0d5e9f13e774abde7ff789b1660#note_1243"
},
"commit": {
"id": "cfe32cf61b73a0d5e9f13e774abde7ff789b1660",
New upstream version 12.9.2
2020-04-08 14:13:33 +05:30
"message": "Add submodule\n\nSigned-off-by: Example User \u003cuser@example.com.com\u003e\n",
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"timestamp": "2014-02-27T10:06:20+02:00",
"url": "http://example.com/gitlab-org/gitlab-test/commit/cfe32cf61b73a0d5e9f13e774abde7ff789b1660",
"author": {
New upstream version 12.9.2
2020-04-08 14:13:33 +05:30
"name": "Example User",
"email": "user@example.com"
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
}
}
}
```
#### Comment on merge request
**Request header**:
New upstream version 12.8.6
2020-03-13 15:44:24 +05:30
```plaintext
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
X-Gitlab-Event: Note Hook
```
**Request body:**
```json
{
"object_kind": "note",
"user": {
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
"id": 1,
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"name": "Administrator",
"username": "root",
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
"avatar_url": "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=40\u0026d=identicon",
"email": "admin@example.com"
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
},
"project_id": 5,
"project":{
New upstream version 10.5.5+dfsg
2018-03-17 18:26:18 +05:30
"id": 5,
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"name":"Gitlab Test",
"description":"Aut reprehenderit ut est.",
"web_url":"http://example.com/gitlab-org/gitlab-test",
"avatar_url":null,
"git_ssh_url":"git@example.com:gitlab-org/gitlab-test.git",
"git_http_url":"http://example.com/gitlab-org/gitlab-test.git",
"namespace":"Gitlab Org",
"visibility_level":10,
"path_with_namespace":"gitlab-org/gitlab-test",
"default_branch":"master",
"homepage":"http://example.com/gitlab-org/gitlab-test",
"url":"http://example.com/gitlab-org/gitlab-test.git",
"ssh_url":"git@example.com:gitlab-org/gitlab-test.git",
"http_url":"http://example.com/gitlab-org/gitlab-test.git"
},
"repository":{
"name": "Gitlab Test",
"url": "http://localhost/gitlab-org/gitlab-test.git",
"description": "Aut reprehenderit ut est.",
"homepage": "http://example.com/gitlab-org/gitlab-test"
},
"object_attributes": {
"id": 1244,
"note": "This MR needs work.",
"noteable_type": "MergeRequest",
"author_id": 1,
"created_at": "2015-05-17 18:21:36 UTC",
"updated_at": "2015-05-17 18:21:36 UTC",
"project_id": 5,
"attachment": null,
"line_code": null,
"commit_id": "",
"noteable_id": 7,
"system": false,
"st_diff": null,
"url": "http://example.com/gitlab-org/gitlab-test/merge_requests/1#note_1244"
},
"merge_request": {
"id": 7,
"target_branch": "markdown",
"source_branch": "master",
"source_project_id": 5,
"author_id": 8,
"assignee_id": 28,
"title": "Tempora et eos debitis quae laborum et.",
"created_at": "2015-03-01 20:12:53 UTC",
"updated_at": "2015-03-21 18:27:27 UTC",
"milestone_id": 11,
"state": "opened",
"merge_status": "cannot_be_merged",
"target_project_id": 5,
"iid": 1,
"description": "Et voluptas corrupti assumenda temporibus. Architecto cum animi eveniet amet asperiores. Vitae numquam voluptate est natus sit et ad id.",
"position": 0,
"source":{
"name":"Gitlab Test",
"description":"Aut reprehenderit ut est.",
"web_url":"http://example.com/gitlab-org/gitlab-test",
"avatar_url":null,
"git_ssh_url":"git@example.com:gitlab-org/gitlab-test.git",
"git_http_url":"http://example.com/gitlab-org/gitlab-test.git",
"namespace":"Gitlab Org",
"visibility_level":10,
"path_with_namespace":"gitlab-org/gitlab-test",
"default_branch":"master",
"homepage":"http://example.com/gitlab-org/gitlab-test",
"url":"http://example.com/gitlab-org/gitlab-test.git",
"ssh_url":"git@example.com:gitlab-org/gitlab-test.git",
"http_url":"http://example.com/gitlab-org/gitlab-test.git"
},
"target": {
"name":"Gitlab Test",
"description":"Aut reprehenderit ut est.",
"web_url":"http://example.com/gitlab-org/gitlab-test",
"avatar_url":null,
"git_ssh_url":"git@example.com:gitlab-org/gitlab-test.git",
"git_http_url":"http://example.com/gitlab-org/gitlab-test.git",
"namespace":"Gitlab Org",
"visibility_level":10,
"path_with_namespace":"gitlab-org/gitlab-test",
"default_branch":"master",
"homepage":"http://example.com/gitlab-org/gitlab-test",
"url":"http://example.com/gitlab-org/gitlab-test.git",
"ssh_url":"git@example.com:gitlab-org/gitlab-test.git",
"http_url":"http://example.com/gitlab-org/gitlab-test.git"
},
"last_commit": {
"id": "562e173be03b8ff2efb05345d12df18815438a4b",
"message": "Merge branch 'another-branch' into 'master'\n\nCheck in this test\n",
"timestamp": "2015-04-08T21: 00:25-07:00",
"url": "http://example.com/gitlab-org/gitlab-test/commit/562e173be03b8ff2efb05345d12df18815438a4b",
"author": {
"name": "John Smith",
"email": "john@example.com"
}
},
"work_in_progress": false,
"assignee": {
"name": "User1",
"username": "user1",
"avatar_url": "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=40\u0026d=identicon"
}
}
}
```
#### Comment on issue
**Request header**:
New upstream version 12.8.6
2020-03-13 15:44:24 +05:30
```plaintext
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
X-Gitlab-Event: Note Hook
```
**Request body:**
```json
{
"object_kind": "note",
"user": {
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
"id": 1,
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"name": "Administrator",
"username": "root",
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
"avatar_url": "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=40\u0026d=identicon",
"email": "admin@example.com"
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
},
"project_id": 5,
"project":{
New upstream version 10.5.5+dfsg
2018-03-17 18:26:18 +05:30
"id": 5,
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"name":"Gitlab Test",
"description":"Aut reprehenderit ut est.",
"web_url":"http://example.com/gitlab-org/gitlab-test",
"avatar_url":null,
"git_ssh_url":"git@example.com:gitlab-org/gitlab-test.git",
"git_http_url":"http://example.com/gitlab-org/gitlab-test.git",
"namespace":"Gitlab Org",
"visibility_level":10,
"path_with_namespace":"gitlab-org/gitlab-test",
"default_branch":"master",
"homepage":"http://example.com/gitlab-org/gitlab-test",
"url":"http://example.com/gitlab-org/gitlab-test.git",
"ssh_url":"git@example.com:gitlab-org/gitlab-test.git",
"http_url":"http://example.com/gitlab-org/gitlab-test.git"
},
"repository":{
"name":"diaspora",
"url":"git@example.com:mike/diaspora.git",
"description":"",
"homepage":"http://example.com/mike/diaspora"
},
"object_attributes": {
"id": 1241,
"note": "Hello world",
"noteable_type": "Issue",
"author_id": 1,
"created_at": "2015-05-17 17:06:40 UTC",
"updated_at": "2015-05-17 17:06:40 UTC",
"project_id": 5,
"attachment": null,
"line_code": null,
"commit_id": "",
"noteable_id": 92,
"system": false,
"st_diff": null,
"url": "http://example.com/gitlab-org/gitlab-test/issues/17#note_1241"
},
"issue": {
"id": 92,
"title": "test",
"assignee_ids": [],
"assignee_id": null,
"author_id": 1,
"project_id": 5,
"created_at": "2015-04-12 14:53:17 UTC",
"updated_at": "2015-04-26 08:28:42 UTC",
"position": 0,
"branch_name": null,
"description": "test",
"milestone_id": null,
"state": "closed",
New upstream version 12.0.8
2019-09-04 21:01:54 +05:30
"iid": 17,
"labels": [
{
"id": 25,
"title": "Afterpod",
"color": "#3e8068",
"project_id": null,
"created_at": "2019-06-05T14:32:20.211Z",
"updated_at": "2019-06-05T14:32:20.211Z",
"template": false,
"description": null,
"type": "GroupLabel",
"group_id": 4
},
{
"id": 86,
"title": "Element",
"color": "#231afe",
"project_id": 4,
"created_at": "2019-06-05T14:32:20.637Z",
"updated_at": "2019-06-05T14:32:20.637Z",
"template": false,
"description": null,
"type": "ProjectLabel",
"group_id": null
}
New upstream version 13.3.8
2020-10-24 23:57:45 +05:30
]
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
}
}
```
New upstream version 13.7.7
2021-02-22 17:27:13 +05:30
NOTE:
`assignee_id` field is deprecated and now shows the first assignee only.
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
#### Comment on code snippet
**Request header**:
New upstream version 12.8.6
2020-03-13 15:44:24 +05:30
```plaintext
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
X-Gitlab-Event: Note Hook
```
**Request body:**
```json
{
"object_kind": "note",
"user": {
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
"id": 1,
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"name": "Administrator",
"username": "root",
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
"avatar_url": "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=40\u0026d=identicon",
"email": "admin@example.com"
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
},
"project_id": 5,
"project":{
New upstream version 10.5.5+dfsg
2018-03-17 18:26:18 +05:30
"id": 5,
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"name":"Gitlab Test",
"description":"Aut reprehenderit ut est.",
"web_url":"http://example.com/gitlab-org/gitlab-test",
"avatar_url":null,
"git_ssh_url":"git@example.com:gitlab-org/gitlab-test.git",
"git_http_url":"http://example.com/gitlab-org/gitlab-test.git",
"namespace":"Gitlab Org",
"visibility_level":10,
"path_with_namespace":"gitlab-org/gitlab-test",
"default_branch":"master",
"homepage":"http://example.com/gitlab-org/gitlab-test",
"url":"http://example.com/gitlab-org/gitlab-test.git",
"ssh_url":"git@example.com:gitlab-org/gitlab-test.git",
"http_url":"http://example.com/gitlab-org/gitlab-test.git"
},
"repository":{
"name":"Gitlab Test",
"url":"http://example.com/gitlab-org/gitlab-test.git",
"description":"Aut reprehenderit ut est.",
"homepage":"http://example.com/gitlab-org/gitlab-test"
},
"object_attributes": {
"id": 1245,
"note": "Is this snippet doing what it's supposed to be doing?",
"noteable_type": "Snippet",
"author_id": 1,
"created_at": "2015-05-17 18:35:50 UTC",
"updated_at": "2015-05-17 18:35:50 UTC",
"project_id": 5,
"attachment": null,
"line_code": null,
"commit_id": "",
"noteable_id": 53,
"system": false,
"st_diff": null,
"url": "http://example.com/gitlab-org/gitlab-test/snippets/53#note_1245"
},
"snippet": {
"id": 53,
"title": "test",
"content": "puts 'Hello world'",
"author_id": 1,
"project_id": 5,
"created_at": "2015-04-09 02:40:38 UTC",
"updated_at": "2015-04-09 02:40:38 UTC",
"file_name": "test.rb",
"expires_at": null,
"type": "ProjectSnippet",
"visibility_level": 0
}
}
```
### Merge request events
Triggered when a new merge request is created, an existing merge request was updated/merged/closed or a commit is added in the source branch.
**Request header**:
New upstream version 12.8.6
2020-03-13 15:44:24 +05:30
```plaintext
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
X-Gitlab-Event: Merge Request Hook
```
**Request body:**
```json
{
"object_kind": "merge_request",
"user": {
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
"id": 1,
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"name": "Administrator",
"username": "root",
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
"avatar_url": "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=40\u0026d=identicon",
"email": "admin@example.com"
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
},
New upstream version 10.5.5+dfsg
2018-03-17 18:26:18 +05:30
"project": {
"id": 1,
"name":"Gitlab Test",
"description":"Aut reprehenderit ut est.",
"web_url":"http://example.com/gitlabhq/gitlab-test",
"avatar_url":null,
"git_ssh_url":"git@example.com:gitlabhq/gitlab-test.git",
"git_http_url":"http://example.com/gitlabhq/gitlab-test.git",
"namespace":"GitlabHQ",
"visibility_level":20,
"path_with_namespace":"gitlabhq/gitlab-test",
"default_branch":"master",
"homepage":"http://example.com/gitlabhq/gitlab-test",
"url":"http://example.com/gitlabhq/gitlab-test.git",
"ssh_url":"git@example.com:gitlabhq/gitlab-test.git",
"http_url":"http://example.com/gitlabhq/gitlab-test.git"
},
"repository": {
"name": "Gitlab Test",
"url": "http://example.com/gitlabhq/gitlab-test.git",
"description": "Aut reprehenderit ut est.",
"homepage": "http://example.com/gitlabhq/gitlab-test"
},
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"object_attributes": {
"id": 99,
"target_branch": "master",
"source_branch": "ms-viewport",
"source_project_id": 14,
"author_id": 51,
"assignee_id": 6,
"title": "MS-Viewport",
"created_at": "2013-12-03T17:23:34Z",
"updated_at": "2013-12-03T17:23:34Z",
"milestone_id": null,
"state": "opened",
"merge_status": "unchecked",
"target_project_id": 14,
"iid": 1,
"description": "",
New upstream version 10.5.5+dfsg
2018-03-17 18:26:18 +05:30
"source": {
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"name":"Awesome Project",
"description":"Aut reprehenderit ut est.",
"web_url":"http://example.com/awesome_space/awesome_project",
"avatar_url":null,
"git_ssh_url":"git@example.com:awesome_space/awesome_project.git",
"git_http_url":"http://example.com/awesome_space/awesome_project.git",
"namespace":"Awesome Space",
"visibility_level":20,
"path_with_namespace":"awesome_space/awesome_project",
"default_branch":"master",
"homepage":"http://example.com/awesome_space/awesome_project",
"url":"http://example.com/awesome_space/awesome_project.git",
"ssh_url":"git@example.com:awesome_space/awesome_project.git",
"http_url":"http://example.com/awesome_space/awesome_project.git"
},
"target": {
"name":"Awesome Project",
"description":"Aut reprehenderit ut est.",
"web_url":"http://example.com/awesome_space/awesome_project",
"avatar_url":null,
"git_ssh_url":"git@example.com:awesome_space/awesome_project.git",
"git_http_url":"http://example.com/awesome_space/awesome_project.git",
"namespace":"Awesome Space",
"visibility_level":20,
"path_with_namespace":"awesome_space/awesome_project",
"default_branch":"master",
"homepage":"http://example.com/awesome_space/awesome_project",
"url":"http://example.com/awesome_space/awesome_project.git",
"ssh_url":"git@example.com:awesome_space/awesome_project.git",
"http_url":"http://example.com/awesome_space/awesome_project.git"
},
"last_commit": {
"id": "da1560886d4f094c3e6c9ef40349f7d38b5d27d7",
"message": "fixed readme",
"timestamp": "2012-01-03T23:36:29+02:00",
"url": "http://example.com/awesome_space/awesome_project/commits/da1560886d4f094c3e6c9ef40349f7d38b5d27d7",
"author": {
"name": "GitLab dev user",
"email": "gitlabdev@dv6700.(none)"
}
},
"work_in_progress": false,
"url": "http://example.com/diaspora/merge_requests/1",
"action": "open",
"assignee": {
"name": "User1",
"username": "user1",
"avatar_url": "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=40\u0026d=identicon"
}
New upstream version 10.5.5+dfsg
2018-03-17 18:26:18 +05:30
},
"labels": [{
"id": 206,
"title": "API",
"color": "#ffffff",
"project_id": 14,
"created_at": "2013-12-03T17:15:43Z",
"updated_at": "2013-12-03T17:15:43Z",
"template": false,
"description": "API related issues",
"type": "ProjectLabel",
"group_id": 41
}],
"changes": {
New upstream version 12.0.8
2019-09-04 21:01:54 +05:30
"updated_by_id": {
"previous": null,
"current": 1
},
"updated_at": {
New upstream version 12.1.11
2019-09-30 21:07:59 +05:30
"previous": "2017-09-15 16:50:55 UTC",
New upstream version 12.0.8
2019-09-04 21:01:54 +05:30
"current":"2017-09-15 16:52:00 UTC"
},
New upstream version 10.5.5+dfsg
2018-03-17 18:26:18 +05:30
"labels": {
"previous": [{
"id": 206,
"title": "API",
"color": "#ffffff",
"project_id": 14,
"created_at": "2013-12-03T17:15:43Z",
"updated_at": "2013-12-03T17:15:43Z",
"template": false,
"description": "API related issues",
"type": "ProjectLabel",
"group_id": 41
}],
"current": [{
"id": 205,
"title": "Platform",
"color": "#123123",
"project_id": 14,
"created_at": "2013-12-03T17:15:43Z",
"updated_at": "2013-12-03T17:15:43Z",
"template": false,
"description": "Platform related issues",
"type": "ProjectLabel",
"group_id": 41
}]
}
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
}
}
```
### Wiki Page events
New upstream version 9.5.4+dfsg
2017-09-10 17:25:29 +05:30
Triggered when a wiki page is created, updated or deleted.
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
**Request Header**:
New upstream version 12.8.6
2020-03-13 15:44:24 +05:30
```plaintext
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
X-Gitlab-Event: Wiki Page Hook
```
**Request Body**:
```json
{
"object_kind": "wiki_page",
"user": {
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
"id": 1,
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"name": "Administrator",
"username": "root",
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
"avatar_url": "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80\u0026d=identicon",
"email": "admin@example.com"
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
},
"project": {
New upstream version 10.5.5+dfsg
2018-03-17 18:26:18 +05:30
"id": 1,
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"name": "awesome-project",
"description": "This is awesome",
"web_url": "http://example.com/root/awesome-project",
"avatar_url": null,
"git_ssh_url": "git@example.com:root/awesome-project.git",
"git_http_url": "http://example.com/root/awesome-project.git",
"namespace": "root",
"visibility_level": 0,
"path_with_namespace": "root/awesome-project",
"default_branch": "master",
"homepage": "http://example.com/root/awesome-project",
"url": "git@example.com:root/awesome-project.git",
"ssh_url": "git@example.com:root/awesome-project.git",
"http_url": "http://example.com/root/awesome-project.git"
},
"wiki": {
New upstream version 12.6.1
2020-01-01 13:55:28 +05:30
"web_url": "http://example.com/root/awesome-project/-/wikis/home",
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"git_ssh_url": "git@example.com:root/awesome-project.wiki.git",
"git_http_url": "http://example.com/root/awesome-project.wiki.git",
"path_with_namespace": "root/awesome-project.wiki",
"default_branch": "master"
},
"object_attributes": {
"title": "Awesome",
"content": "awesome content goes here",
"format": "markdown",
"message": "adding an awesome page to the wiki",
"slug": "awesome",
New upstream version 12.6.1
2020-01-01 13:55:28 +05:30
"url": "http://example.com/root/awesome-project/-/wikis/awesome",
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"action": "create"
}
}
```
### Pipeline events
New upstream version 13.9.3+ds1
2021-03-11 19:13:27 +05:30
In [GitLab 13.9](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/53159)
and later, the pipeline webhook returns only the latest jobs.
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
Triggered on status change of Pipeline.
**Request Header**:
New upstream version 12.8.6
2020-03-13 15:44:24 +05:30
```plaintext
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
X-Gitlab-Event: Pipeline Hook
```
**Request Body**:
```json
{
"object_kind": "pipeline",
"object_attributes":{
"id": 31,
"ref": "master",
"tag": false,
"sha": "bcbb5ec396a2c0f828686f14fac9b80b780504f2",
"before_sha": "bcbb5ec396a2c0f828686f14fac9b80b780504f2",
New upstream version 12.3.8
2019-12-04 20:38:33 +05:30
"source": "merge_request_event",
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"status": "success",
"stages":[
"build",
"test",
"deploy"
],
"created_at": "2016-08-12 15:23:28 UTC",
"finished_at": "2016-08-12 15:26:29 UTC",
New upstream version 11.4.9+dfsg
2018-12-05 23:21:45 +05:30
"duration": 63,
"variables": [
{
"key": "NESTOR_PROD_ENVIRONMENT",
"value": "us-west-1"
}
]
New upstream version 12.3.8
2019-12-04 20:38:33 +05:30
},
"merge_request": {
"id": 1,
"iid": 1,
"title": "Test",
"source_branch": "test",
"source_project_id": 1,
"target_branch": "master",
"target_project_id": 1,
"state": "opened",
"merge_status": "can_be_merged",
"url": "http://192.168.64.1:3005/gitlab-org/gitlab-test/merge_requests/1"
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
},
"user":{
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
"id": 1,
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"name": "Administrator",
"username": "root",
New upstream version 12.8.6
2020-03-13 15:44:24 +05:30
"avatar_url": "http://www.gravatar.com/avatar/e32bd13e2add097461cb96824b7a829c?s=80\u0026d=identicon",
"email": "user_email@gitlab.com"
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
},
"project":{
New upstream version 10.5.5+dfsg
2018-03-17 18:26:18 +05:30
"id": 1,
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"name": "Gitlab Test",
"description": "Atque in sunt eos similique dolores voluptatem.",
"web_url": "http://192.168.64.1:3005/gitlab-org/gitlab-test",
"avatar_url": null,
"git_ssh_url": "git@192.168.64.1:gitlab-org/gitlab-test.git",
"git_http_url": "http://192.168.64.1:3005/gitlab-org/gitlab-test.git",
"namespace": "Gitlab Org",
"visibility_level": 20,
"path_with_namespace": "gitlab-org/gitlab-test",
"default_branch": "master"
},
"commit":{
"id": "bcbb5ec396a2c0f828686f14fac9b80b780504f2",
"message": "test\n",
"timestamp": "2016-08-12T17:23:21+02:00",
"url": "http://example.com/gitlab-org/gitlab-test/commit/bcbb5ec396a2c0f828686f14fac9b80b780504f2",
"author":{
"name": "User",
"email": "user@gitlab.com"
}
},
New upstream version 12.0.8
2019-09-04 21:01:54 +05:30
"builds":[
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
{
"id": 380,
"stage": "deploy",
"name": "production",
"status": "skipped",
"created_at": "2016-08-12 15:23:28 UTC",
"started_at": null,
"finished_at": null,
"when": "manual",
"manual": true,
New upstream version 12.6.1
2020-01-01 13:55:28 +05:30
"allow_failure": false,
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"user":{
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
"id": 1,
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"name": "Administrator",
"username": "root",
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
"avatar_url": "http://www.gravatar.com/avatar/e32bd13e2add097461cb96824b7a829c?s=80\u0026d=identicon",
"email": "admin@example.com"
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
},
"runner": null,
"artifacts_file":{
"filename": null,
"size": null
New upstream version 13.10.3+ds1
2021-04-17 20:07:23 +05:30
},
"environment": {
"name": "production",
"action": "start"
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
}
},
{
"id": 377,
"stage": "test",
"name": "test-image",
"status": "success",
"created_at": "2016-08-12 15:23:28 UTC",
"started_at": "2016-08-12 15:26:12 UTC",
"finished_at": null,
"when": "on_success",
"manual": false,
New upstream version 12.6.1
2020-01-01 13:55:28 +05:30
"allow_failure": false,
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"user":{
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
"id": 1,
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"name": "Administrator",
"username": "root",
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
"avatar_url": "http://www.gravatar.com/avatar/e32bd13e2add097461cb96824b7a829c?s=80\u0026d=identicon",
"email": "admin@example.com"
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
},
New upstream version 11.10.8+dfsg
2019-07-07 11:18:12 +05:30
"runner": {
New upstream version 13.9.3+ds1
2021-03-11 19:13:27 +05:30
"id": 380987,
"description": "shared-runners-manager-6.gitlab.com",
"active": true,
"is_shared": true,
"tags": [
"linux",
"docker",
"shared-runner"
]
New upstream version 11.10.8+dfsg
2019-07-07 11:18:12 +05:30
},
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"artifacts_file":{
"filename": null,
"size": null
New upstream version 13.10.3+ds1
2021-04-17 20:07:23 +05:30
},
"environment": null
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
},
{
"id": 378,
"stage": "test",
"name": "test-build",
"status": "success",
"created_at": "2016-08-12 15:23:28 UTC",
"started_at": "2016-08-12 15:26:12 UTC",
"finished_at": "2016-08-12 15:26:29 UTC",
"when": "on_success",
"manual": false,
New upstream version 12.6.1
2020-01-01 13:55:28 +05:30
"allow_failure": false,
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"user":{
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
"id": 1,
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"name": "Administrator",
"username": "root",
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
"avatar_url": "http://www.gravatar.com/avatar/e32bd13e2add097461cb96824b7a829c?s=80\u0026d=identicon",
"email": "admin@example.com"
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
},
New upstream version 11.10.8+dfsg
2019-07-07 11:18:12 +05:30
"runner": {
"id":380987,
"description":"shared-runners-manager-6.gitlab.com",
"active":true,
New upstream version 13.9.3+ds1
2021-03-11 19:13:27 +05:30
"is_shared":true,
"tags": [
"linux",
"docker"
]
New upstream version 11.10.8+dfsg
2019-07-07 11:18:12 +05:30
},
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"artifacts_file":{
"filename": null,
"size": null
New upstream version 13.10.3+ds1
2021-04-17 20:07:23 +05:30
},
"environment": null
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
},
{
"id": 376,
"stage": "build",
"name": "build-image",
"status": "success",
"created_at": "2016-08-12 15:23:28 UTC",
"started_at": "2016-08-12 15:24:56 UTC",
"finished_at": "2016-08-12 15:25:26 UTC",
"when": "on_success",
"manual": false,
New upstream version 12.6.1
2020-01-01 13:55:28 +05:30
"allow_failure": false,
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"user":{
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
"id": 1,
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"name": "Administrator",
"username": "root",
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
"avatar_url": "http://www.gravatar.com/avatar/e32bd13e2add097461cb96824b7a829c?s=80\u0026d=identicon",
"email": "admin@example.com"
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
},
New upstream version 11.10.8+dfsg
2019-07-07 11:18:12 +05:30
"runner": {
New upstream version 13.9.3+ds1
2021-03-11 19:13:27 +05:30
"id": 380987,
"description": "shared-runners-manager-6.gitlab.com",
"active": true,
"is_shared": true,
"tags": [
"linux",
"docker"
]
New upstream version 11.10.8+dfsg
2019-07-07 11:18:12 +05:30
},
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"artifacts_file":{
"filename": null,
"size": null
New upstream version 13.10.3+ds1
2021-04-17 20:07:23 +05:30
},
"environment": null
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
},
{
"id": 379,
"stage": "deploy",
"name": "staging",
"status": "created",
"created_at": "2016-08-12 15:23:28 UTC",
"started_at": null,
"finished_at": null,
"when": "on_success",
"manual": false,
New upstream version 12.6.1
2020-01-01 13:55:28 +05:30
"allow_failure": false,
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"user":{
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
"id": 1,
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"name": "Administrator",
"username": "root",
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
"avatar_url": "http://www.gravatar.com/avatar/e32bd13e2add097461cb96824b7a829c?s=80\u0026d=identicon",
"email": "admin@example.com"
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
},
"runner": null,
"artifacts_file":{
"filename": null,
"size": null
New upstream version 13.10.3+ds1
2021-04-17 20:07:23 +05:30
},
"environment": {
"name": "staging",
"action": "start"
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
}
}
]
}
```
New upstream version 11.10.8+dfsg
2019-07-07 11:18:12 +05:30
### Job events
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
New upstream version 11.10.8+dfsg
2019-07-07 11:18:12 +05:30
Triggered on status change of a job.
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
**Request Header**:
New upstream version 12.8.6
2020-03-13 15:44:24 +05:30
```plaintext
New upstream version 11.10.8+dfsg
2019-07-07 11:18:12 +05:30
X-Gitlab-Event: Job Hook
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
```
**Request Body**:
```json
{
New upstream version 12.3.8
2019-12-04 20:38:33 +05:30
"object_kind": "build",
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"ref": "gitlab-script-trigger",
"tag": false,
"before_sha": "2293ada6b400935a1378653304eaf6221e0fdb8f",
"sha": "2293ada6b400935a1378653304eaf6221e0fdb8f",
New upstream version 12.3.8
2019-12-04 20:38:33 +05:30
"build_id": 1977,
"build_name": "test",
"build_stage": "test",
"build_status": "created",
New upstream version 13.11.2+ds1
2021-04-29 21:17:54 +05:30
"build_created_at": "2021-02-23T02:41:37.886Z",
New upstream version 12.3.8
2019-12-04 20:38:33 +05:30
"build_started_at": null,
"build_finished_at": null,
"build_duration": null,
"build_allow_failure": false,
"build_failure_reason": "script_failure",
New upstream version 12.6.1
2020-01-01 13:55:28 +05:30
"pipeline_id": 2366,
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
"project_id": 380,
"project_name": "gitlab-org/gitlab-test",
"user": {
"id": 3,
"name": "User",
New upstream version 12.8.6
2020-03-13 15:44:24 +05:30
"email": "user@gitlab.com",
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
"avatar_url": "http://www.gravatar.com/avatar/e32bd13e2add097461cb96824b7a829c?s=80\u0026d=identicon",
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
},
"commit": {
"id": 2366,
"sha": "2293ada6b400935a1378653304eaf6221e0fdb8f",
"message": "test\n",
"author_name": "User",
"author_email": "user@gitlab.com",
"status": "created",
"duration": null,
"started_at": null,
"finished_at": null
},
"repository": {
"name": "gitlab_test",
"description": "Atque in sunt eos similique dolores voluptatem.",
"homepage": "http://192.168.64.1:3005/gitlab-org/gitlab-test",
"git_ssh_url": "git@192.168.64.1:gitlab-org/gitlab-test.git",
"git_http_url": "http://192.168.64.1:3005/gitlab-org/gitlab-test.git",
"visibility_level": 20
New upstream version 12.6.1
2020-01-01 13:55:28 +05:30
},
"runner": {
"active": true,
"is_shared": false,
"id": 380987,
New upstream version 13.9.3+ds1
2021-03-11 19:13:27 +05:30
"description": "shared-runners-manager-6.gitlab.com",
"tags": [
"linux",
"docker"
]
New upstream version 13.10.3+ds1
2021-04-17 20:07:23 +05:30
},
"environment": null
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
}
```
New upstream version 13.0.0
2020-05-24 23:13:21 +05:30
Note that `commit.id` is the ID of the pipeline, not the ID of the commit.
New upstream version 12.6.1
2020-01-01 13:55:28 +05:30
New upstream version 13.3.8
2020-10-24 23:57:45 +05:30
### Deployment events
New upstream version 13.5.5
2021-01-03 14:25:43 +05:30
Triggered when a deployment:
- Starts ([Introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/41214) in GitLab 13.5.)
- Succeeds
- Fails
- Is cancelled
New upstream version 13.3.8
2020-10-24 23:57:45 +05:30
**Request Header**:
```plaintext
X-Gitlab-Event: Deployment Hook
```
**Request Body**:
```json
{
"object_kind": "deployment",
"status": "success",
"deployable_id": 796,
"deployable_url": "http://10.126.0.2:3000/root/test-deployment-webhooks/-/jobs/796",
"environment": "staging",
"project": {
"id": 30,
"name": "test-deployment-webhooks",
"description": "",
"web_url": "http://10.126.0.2:3000/root/test-deployment-webhooks",
"avatar_url": null,
"git_ssh_url": "ssh://vlad@10.126.0.2:2222/root/test-deployment-webhooks.git",
"git_http_url": "http://10.126.0.2:3000/root/test-deployment-webhooks.git",
"namespace": "Administrator",
"visibility_level": 0,
"path_with_namespace": "root/test-deployment-webhooks",
"default_branch": "master",
"ci_config_path": "",
"homepage": "http://10.126.0.2:3000/root/test-deployment-webhooks",
"url": "ssh://vlad@10.126.0.2:2222/root/test-deployment-webhooks.git",
"ssh_url": "ssh://vlad@10.126.0.2:2222/root/test-deployment-webhooks.git",
"http_url": "http://10.126.0.2:3000/root/test-deployment-webhooks.git"
},
"short_sha": "279484c0",
"user": {
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
"id": 1,
New upstream version 13.3.8
2020-10-24 23:57:45 +05:30
"name": "Administrator",
"username": "root",
"avatar_url": "https://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon",
"email": "admin@example.com"
},
"user_url": "http://10.126.0.2:3000/root",
"commit_url": "http://10.126.0.2:3000/root/test-deployment-webhooks/-/commit/279484c09fbe69ededfced8c1bb6e6d24616b468",
"commit_title": "Add new file"
}
```
Note that `deployable_id` is the ID of the CI job.
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
### Group member events **(PREMIUM)**
New upstream version 13.7.7
2021-02-22 17:27:13 +05:30
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/260347) in GitLab 13.7.
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
Member events are triggered when:
- A user is added as a group member
- The access level of a user has changed
- The expiration date for user access has been updated
- A user has been removed from the group
#### Add member to group
New upstream version 13.7.7
2021-02-22 17:27:13 +05:30
**Request Header**:
```plaintext
X-Gitlab-Event: Member Hook
```
**Request Body**:
```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,
"group_access": "Guest",
"group_plan": null,
"expires_at": "2020-12-14T00:00:00Z",
"event_name": "user_add_to_group"
}
```
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
#### Update member access level or expiration date
**Request Header**:
```plaintext
X-Gitlab-Event: Member Hook
```
**Request Body**:
```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,
"group_access": "Developer",
"group_plan": null,
"expires_at": "2020-12-20T00:00:00Z",
"event_name": "user_update_for_group"
}
```
#### Remove member from group
**Request Header**:
```plaintext
X-Gitlab-Event: Member Hook
```
**Request Body**:
```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,
"group_access": "Guest",
"group_plan": null,
"expires_at": "2020-12-14T00:00:00Z",
"event_name": "user_remove_from_group"
}
```
New upstream version 13.9.3+ds1
2021-03-11 19:13:27 +05:30
### Subgroup events **(PREMIUM)**
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/260419) in GitLab 13.9.
Subgroup events are triggered when:
- A [subgroup is created in a group](#subgroup-created-in-a-group)
- A [subgroup is removed from a group](#subgroup-removed-from-a-group)
#### Subgroup created in a group
**Request Header**:
```plaintext
X-Gitlab-Event: Subgroup Hook
```
**Request Body**:
```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",
"parent_path": "group1",
"parent_full_path": "group1"
}
```
#### Subgroup removed from a group
**Request Header**:
```plaintext
X-Gitlab-Event: Subgroup Hook
```
**Request Body**:
```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",
"parent_path": "group1",
"parent_full_path": "group1"
}
```
NOTE:
New upstream version 13.10.3+ds1
2021-04-17 20:07:23 +05:30
Webhooks for when a [subgroup is removed from a group](#subgroup-removed-from-a-group) are not triggered when a [subgroup is transferred to a new parent group](../../group/index.md#transfer-a-group)
New upstream version 13.9.3+ds1
2021-03-11 19:13:27 +05:30
New upstream version 13.6.5
2021-01-29 00:20:46 +05:30
### Feature Flag events
Triggered when a feature flag is turned on or off.
**Request Header**:
```plaintext
X-Gitlab-Event: Feature Flag Hook
```
**Request Body**:
```json
{
"object_kind": "feature_flag",
"project": {
"id": 1,
"name":"Gitlab Test",
"description":"Aut reprehenderit ut est.",
"web_url":"http://example.com/gitlabhq/gitlab-test",
"avatar_url":null,
"git_ssh_url":"git@example.com:gitlabhq/gitlab-test.git",
"git_http_url":"http://example.com/gitlabhq/gitlab-test.git",
"namespace":"GitlabHQ",
"visibility_level":20,
"path_with_namespace":"gitlabhq/gitlab-test",
"default_branch":"master",
"ci_config_path": null,
"homepage":"http://example.com/gitlabhq/gitlab-test",
"url":"http://example.com/gitlabhq/gitlab-test.git",
"ssh_url":"git@example.com:gitlabhq/gitlab-test.git",
"http_url":"http://example.com/gitlabhq/gitlab-test.git"
},
"user": {
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
"id": 1,
New upstream version 13.6.5
2021-01-29 00:20:46 +05:30
"name": "Administrator",
"username": "root",
"avatar_url": "https://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon",
"email": "admin@example.com"
},
"user_url": "http://example.com/root",
"object_attributes": {
"id": 6,
"name": "test-feature-flag",
"description": "test-feature-flag-description",
"active": true
}
}
```
### Release events
Triggered when a release is created or updated.
**Request Header**:
```plaintext
X-Gitlab-Event: Release Hook
```
**Request Body**:
```json
{
"id": 1,
"created_at": "2020-11-02 12:55:12 UTC",
"description": "v1.0 has been released",
"name": "v1.1",
"released_at": "2020-11-02 12:55:12 UTC",
"tag": "v1.1",
"object_kind": "release",
"project": {
"id": 2,
"name": "release-webhook-example",
"description": "",
"web_url": "https://example.com/gitlab-org/release-webhook-example",
"avatar_url": null,
"git_ssh_url": "ssh://git@example.com/gitlab-org/release-webhook-example.git",
"git_http_url": "https://example.com/gitlab-org/release-webhook-example.git",
"namespace": "Gitlab",
"visibility_level": 0,
"path_with_namespace": "gitlab-org/release-webhook-example",
"default_branch": "master",
"ci_config_path": null,
"homepage": "https://example.com/gitlab-org/release-webhook-example",
"url": "ssh://git@example.com/gitlab-org/release-webhook-example.git",
"ssh_url": "ssh://git@example.com/gitlab-org/release-webhook-example.git",
"http_url": "https://example.com/gitlab-org/release-webhook-example.git"
},
"url": "https://example.com/gitlab-org/release-webhook-example/-/releases/v1.1",
"action": "create",
"assets": {
"count": 5,
"links": [
{
"id": 1,
"external": true,
"link_type": "other",
"name": "Changelog",
"url": "https://example.net/changelog"
}
],
"sources": [
{
"format": "zip",
"url": "https://example.com/gitlab-org/release-webhook-example/-/archive/v1.1/release-webhook-example-v1.1.zip"
},
{
"format": "tar.gz",
"url": "https://example.com/gitlab-org/release-webhook-example/-/archive/v1.1/release-webhook-example-v1.1.tar.gz"
},
{
"format": "tar.bz2",
"url": "https://example.com/gitlab-org/release-webhook-example/-/archive/v1.1/release-webhook-example-v1.1.tar.bz2"
},
{
"format": "tar",
"url": "https://example.com/gitlab-org/release-webhook-example/-/archive/v1.1/release-webhook-example-v1.1.tar"
}
]
},
"commit": {
"id": "ee0a3fb31ac16e11b9dbb596ad16d4af654d08f8",
"message": "Release v1.1",
"title": "Release v1.1",
"timestamp": "2020-10-31T14:58:32+11:00",
"url": "https://example.com/gitlab-org/release-webhook-example/-/commit/ee0a3fb31ac16e11b9dbb596ad16d4af654d08f8",
"author": {
"name": "Example User",
"email": "user@example.com"
}
}
}
```
New upstream version 11.2.8+dfsg
2018-11-18 11:00:15 +05:30
## Image URL rewriting
From GitLab 11.2, simple image references are rewritten to use an absolute URL
in webhooks. So if an image, merge request, comment, or wiki page has this in
its description:
```markdown
![image](/uploads/$sha/image.png)
```
New upstream version 13.7.7
2021-02-22 17:27:13 +05:30
It appears in the webhook body as follows assuming that:
- GitLab is installed at `gitlab.example.com`.
- The project is at `example-group/example-project`.
New upstream version 11.2.8+dfsg
2018-11-18 11:00:15 +05:30
```markdown
New upstream version 11.5.3+dfsg
2018-12-13 13:39:08 +05:30
![image](https://gitlab.example.com/example-group/example-project/uploads/$sha/image.png)
New upstream version 11.2.8+dfsg
2018-11-18 11:00:15 +05:30
```
New upstream version 13.7.7
2021-02-22 17:27:13 +05:30
This doesn't rewrite URLs that already are pointing to HTTP, HTTPS, or
protocol-relative URLs. It also doesn't rewrite image URLs using advanced
New upstream version 11.2.8+dfsg
2018-11-18 11:00:15 +05:30
Markdown features, like link labels.
New upstream version 9.5.4+dfsg
2017-09-10 17:25:29 +05:30
## Testing webhooks
New upstream version 13.7.7
2021-02-22 17:27:13 +05:30
You can trigger the webhook manually. Sample data from the project is used.
New upstream version 13.8.5+ds1
2021-03-08 18:12:59 +05:30
For example, for triggering `Push Events` your project should have at least one commit.
New upstream version 9.5.4+dfsg
2017-09-10 17:25:29 +05:30
![Webhook testing](img/webhook_testing.png)
## Troubleshoot webhooks
New upstream version 11.4.9+dfsg
2018-12-05 23:21:45 +05:30
GitLab stores each perform of the webhook.
New upstream version 9.5.4+dfsg
2017-09-10 17:25:29 +05:30
You can find records for last 2 days in "Recent Deliveries" section on the edit page of each webhook.
![Recent deliveries](img/webhook_logs.png)
New upstream version 13.7.7
2021-02-22 17:27:13 +05:30
In this section you can see:
- HTTP status code (green for `200-299` codes, red for the others, `internal error` for failed deliveries).
- Triggered event.
- A time when the event was called.
- Elapsed time of the request.
New upstream version 9.5.4+dfsg
2017-09-10 17:25:29 +05:30
If you need more information about execution, you can click `View details` link.
On this page, you can see data that GitLab sends (request headers and body) and data that it received (response headers and body).
From this page, you can repeat delivery with the same data by clicking `Resend Request` button.
New upstream version 13.7.7
2021-02-22 17:27:13 +05:30
NOTE:
If URL or secret token of the webhook were updated, data is delivered to the new address.
New upstream version 9.5.4+dfsg
2017-09-10 17:25:29 +05:30
New upstream version 13.7.7
2021-02-22 17:27:13 +05:30
### Webhook fails or multiple webhook requests are triggered
New upstream version 10.5.5+dfsg
2018-03-17 18:26:18 +05:30
New upstream version 13.7.7
2021-02-22 17:27:13 +05:30
When GitLab sends a webhook, it expects a response in 10 seconds by default. If it does not receive
one, it retries the webhook. If the endpoint doesn't send its HTTP response within those 10 seconds,
GitLab may decide the hook failed and retry it.
New upstream version 10.5.5+dfsg
2018-03-17 18:26:18 +05:30
New upstream version 13.7.7
2021-02-22 17:27:13 +05:30
If your webhooks are failing or you are receiving multiple requests, you can try changing the
default value. You can do this by uncommenting or adding the following setting to your
`/etc/gitlab/gitlab.rb` file:
New upstream version 10.5.5+dfsg
2018-03-17 18:26:18 +05:30
New upstream version 12.8.6
2020-03-13 15:44:24 +05:30
```ruby
New upstream version 11.1.8+dfsg
2018-11-08 19:23:39 +05:30
gitlab_rails['webhook_timeout'] = 10
New upstream version 10.5.5+dfsg
2018-03-17 18:26:18 +05:30
```
New upstream version 13.7.7
2021-02-22 17:27:13 +05:30
### Unable to get local issuer certificate
New upstream version 11.10.8+dfsg
2019-07-07 11:18:12 +05:30
When SSL verification is enabled, this error indicates that GitLab isn't able to verify the SSL certificate of the webhook endpoint.
Typically, this is because the root certificate isn't issued by a trusted certification authority as
determined by [CAcert.org](http://www.cacert.org/).
Should that not be the case, consider using [SSL Checker](https://www.sslshopper.com/ssl-checker.html) to identify faults.
Missing intermediate certificates are a common point of verification failure.
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
## Example webhook receiver
New upstream version 13.7.7
2021-02-22 17:27:13 +05:30
If you want to see GitLab webhooks in action for testing purposes you can use
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
a simple echo script running in a console session. For the following script to
work you need to have Ruby installed.
Save the following file as `print_http_body.rb`:
```ruby
require 'webrick'
server = WEBrick::HTTPServer.new(:Port => ARGV.first)
server.mount_proc '/' do |req, res|
puts req.body
end
trap 'INT' do
server.shutdown
end
server.start
```
New upstream version 13.7.7
2021-02-22 17:27:13 +05:30
Pick an unused port (for example, `8000`) and start the script: `ruby print_http_body.rb
New upstream version 12.8.6
2020-03-13 15:44:24 +05:30
8000`. Then add your server as a webhook receiver in GitLab as
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
`http://my.host:8000/`.
New upstream version 9.5.4+dfsg
2017-09-10 17:25:29 +05:30
When you press 'Test' in GitLab, you should see something like this in the
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
console:
New upstream version 12.8.6
2020-03-13 15:44:24 +05:30
```plaintext
New upstream version 9.2.10+dfsg
2017-08-17 22:00:37 +05:30
{"before":"077a85dd266e6f3573ef7e9ef8ce3343ad659c4e","after":"95cd4a99e93bc4bbabacfa2cd10e6725b1403c60",<SNIP>}
example.com - - [14/May/2014:07:45:26 EDT] "POST / HTTP/1.1" 200 0
- -> /
```
New upstream version 12.3.8
2019-12-04 20:38:33 +05:30
New upstream version 13.7.7
2021-02-22 17:27:13 +05:30
NOTE:
You may need to [allow requests to the local network](../../../security/webhooks.md) for this
receiver to be added.
Reference in a new issue Copy permalink