GitLab · JSON Structure

Gitlab Webhooks Webhook Structure

Webhook from GitLab API

Type: object Properties: 24
CodePlatformSoftware DevelopmentSource Control

Webhook is a JSON Structure definition published by GitLab, describing 24 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

id url name description project_id created_at push_events tag_push_events issues_events confidential_issues_events merge_requests_events note_events confidential_note_events job_events pipeline_events wiki_page_events deployment_events releases_events member_events enable_ssl_verification push_events_branch_filter branch_filter_strategy alert_status disabled_until

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/gitlab/refs/heads/main/json-structure/gitlab-webhooks-webhook-structure.json",
  "name": "Webhook",
  "description": "Webhook from GitLab API",
  "type": "object",
  "properties": {
    "id": {
      "type": "int32",
      "description": "The unique identifier of the webhook.",
      "example": 42
    },
    "url": {
      "type": "uri",
      "description": "The URL that receives webhook POST requests.",
      "example": "https://gitlab.com/example"
    },
    "name": {
      "type": "string",
      "description": "Optional name for the webhook.",
      "example": "Example Project"
    },
    "description": {
      "type": "string",
      "description": "Optional description of the webhook.",
      "example": "Example description"
    },
    "project_id": {
      "type": "int32",
      "description": "The ID of the project the webhook belongs to.",
      "example": 42
    },
    "created_at": {
      "type": "datetime",
      "description": "The date and time the webhook was created.",
      "example": "2026-04-17T12:00:00Z"
    },
    "push_events": {
      "type": "boolean",
      "description": "Whether the webhook triggers on push events.",
      "example": true
    },
    "tag_push_events": {
      "type": "boolean",
      "description": "Whether the webhook triggers on tag push events.",
      "example": true
    },
    "issues_events": {
      "type": "boolean",
      "description": "Whether the webhook triggers on issue events.",
      "example": true
    },
    "confidential_issues_events": {
      "type": "boolean",
      "description": "Whether the webhook triggers on confidential issue events.",
      "example": true
    },
    "merge_requests_events": {
      "type": "boolean",
      "description": "Whether the webhook triggers on merge request events.",
      "example": true
    },
    "note_events": {
      "type": "boolean",
      "description": "Whether the webhook triggers on comment events.",
      "example": true
    },
    "confidential_note_events": {
      "type": "boolean",
      "description": "Whether the webhook triggers on confidential comment events.",
      "example": true
    },
    "job_events": {
      "type": "boolean",
      "description": "Whether the webhook triggers on job status change events.",
      "example": true
    },
    "pipeline_events": {
      "type": "boolean",
      "description": "Whether the webhook triggers on pipeline status change events.",
      "example": true
    },
    "wiki_page_events": {
      "type": "boolean",
      "description": "Whether the webhook triggers on wiki page events.",
      "example": true
    },
    "deployment_events": {
      "type": "boolean",
      "description": "Whether the webhook triggers on deployment events.",
      "example": true
    },
    "releases_events": {
      "type": "boolean",
      "description": "Whether the webhook triggers on release events.",
      "example": true
    },
    "member_events": {
      "type": "boolean",
      "description": "Whether the webhook triggers on group member events.",
      "example": true
    },
    "enable_ssl_verification": {
      "type": "boolean",
      "description": "Whether SSL certificate verification is enabled for the webhook URL.",
      "example": true
    },
    "push_events_branch_filter": {
      "type": "string",
      "description": "Branch name or wildcard pattern to filter push events.",
      "example": "main"
    },
    "branch_filter_strategy": {
      "type": "string",
      "enum": [
        "wildcard",
        "regex",
        "all_branches"
      ],
      "description": "The strategy used for filtering branches.",
      "example": "wildcard"
    },
    "alert_status": {
      "type": "string",
      "description": "The current alert status of the webhook based on delivery failures.",
      "example": "2026-04-17T12:00:00Z"
    },
    "disabled_until": {
      "type": "datetime",
      "description": "If set, the webhook is temporarily disabled until this time.",
      "example": "example_value"
    }
  }
}

Work with this as data

Every JSON Structure here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for json structure

4 MCP tools reach this
  • find_json_structuresBrowse and filter every JSON Structure in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Structure
curl "https://apis.io/api/v1/json-structures/gitlab-webhooks-webhook-structure"
All json structure
curl "https://apis.io/api/v1/json-structures?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.