Skip to content

Create a group hook

POST
/api/v4/groups/{id}/hooks

Creates a hook for a specified group.

id
required
One of:
string

The ID or URL-encoded path of the group

Media type application/json
object
url
required

The URL to send the request to

string
nullable
Example
http://example.com/hook
name

Name of the hook

string
nullable
description

Description of the hook

string
nullable
push_events

Trigger hook on push events

boolean
nullable
push_events_branch_filter

Respond to push events only on branches that match this filter

string
nullable
issues_events

Trigger hook on issues events

boolean
nullable
confidential_issues_events

Trigger hook on confidential issues events

boolean
nullable
merge_requests_events

Trigger hook on merge request events

boolean
nullable
tag_push_events

Trigger hook on tag push events

boolean
nullable
note_events

Trigger hook on note(comment) events

boolean
nullable
confidential_note_events

Trigger hook on confidential note(comment) events

boolean
nullable
job_events

Trigger hook on job events

boolean
nullable
pipeline_events

Trigger hook on pipeline events

boolean
nullable
project_events

Trigger hook on project events

boolean
nullable
wiki_page_events

Trigger hook on wiki events

boolean
nullable
deployment_events

Trigger hook on deployment events

boolean
nullable
feature_flag_events

Trigger hook on feature flag events

boolean
nullable
releases_events

Trigger hook on release events

boolean
nullable
milestone_events

Trigger hook on milestone events

boolean
nullable
subgroup_events

Trigger hook on subgroup events

boolean
nullable
emoji_events

Trigger hook on emoji events

boolean
nullable
resource_access_token_events

Trigger hook on group access token expiry events

boolean
nullable
member_events

Trigger hook on member events

boolean
nullable
vulnerability_events

Trigger hook on vulnerability events

boolean
nullable
enable_ssl_verification

Do SSL verification when triggering the hook

boolean
nullable
token

Secret token to validate received payloads; this will not be returned in the response

string
nullable
signing_token

HMAC signing token used to compute the webhook-signature header. Must be in whsec_ format encoding a 32-byte key. Not returned in the response

string
nullable
custom_webhook_template

Custom template for the request payload

string
nullable
branch_filter_strategy

Filter push events by branch. Possible values are wildcard (default), regex, and all_branches

string
nullable
Allowed values: wildcard regex all_branches
url_variables

URL variables for interpolation

Array<object>
nullable
object
key
required

Name of the variable

string
nullable
Example
token
value
required

Value of the variable

string
nullable
Example
123
custom_headers

Custom headers

Array<object>
nullable
object
key
required

Name of the header

string
nullable
Example
X-Custom-Header
value
required

Value of the header

string
nullable
Example
value

Created

Media type application/json
object
id
integer format: int64
url
string
name
string
description
string
created_at
string format: date-time
push_events
boolean
tag_push_events
boolean
merge_requests_events
boolean
repository_update_events
boolean
enable_ssl_verification
boolean
organization_id
integer
alert_status
string
disabled_until
string format: date-time
url_variables
Array<object>
object
push_events_branch_filter
string
branch_filter_strategy
string
custom_webhook_template
string
custom_headers
Array<object>
object
token_present

Whether a secret token is configured

boolean
signing_token_present

Whether an HMAC signing token is configured

boolean
group_id
integer format: int64
issues_events
boolean
confidential_issues_events
boolean
note_events
boolean
confidential_note_events
boolean
pipeline_events
boolean
wiki_page_events
boolean
job_events
boolean
deployment_events
boolean
feature_flag_events
boolean
releases_events
boolean
milestone_events
boolean
subgroup_events
boolean
emoji_events
boolean
resource_access_token_events
boolean
member_events
boolean
vulnerability_events
boolean
project_events
boolean
Example
{
"id": 1,
"url": "https://webhook.site",
"name": "Hook name",
"description": "Hook description",
"created_at": "2012-05-28T04:42:42-07:00",
"organization_id": 1,
"alert_status": ":executable",
"disabled_until": "2012-05-28T04:42:42-07:00",
"url_variables": [
{
"token": "secr3t"
}
],
"push_events_branch_filter": "my-branch-*",
"branch_filter_strategy": "wildcard",
"custom_webhook_template": "{\"event\":\"{{object_kind}}\"}",
"custom_headers": [
{
"X-Custom-Header": "value"
}
],
"token_present": false,
"signing_token_present": false,
"group_id": 1
}

Validation error

Not found

Unprocessable entity