GitLab · JSON Structure

Gitlab Webhooks Webhook Input Structure

WebhookInput from GitLab API

Type: object Properties: 19 Required: 1
CodePlatformSoftware DevelopmentSource Control

WebhookInput is a JSON Structure definition published by GitLab, describing 19 properties, of which 1 is required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

url name description secret_token enable_ssl_verification 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 push_events_branch_filter

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-input-structure.json",
  "name": "WebhookInput",
  "description": "WebhookInput from GitLab API",
  "type": "object",
  "properties": {
    "url": {
      "type": "uri",
      "description": "The URL to send webhook POST requests to.",
      "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"
    },
    "secret_token": {
      "type": "string",
      "description": "A secret token to validate received payloads. Sent as the X-Gitlab-Token header.",
      "example": "glpat-example-token"
    },
    "enable_ssl_verification": {
      "type": "boolean",
      "description": "Whether to verify SSL certificates on the webhook URL.",
      "example": true
    },
    "push_events": {
      "type": "boolean",
      "description": "Trigger on push events.",
      "example": true
    },
    "tag_push_events": {
      "type": "boolean",
      "description": "Trigger on tag push events.",
      "example": true
    },
    "issues_events": {
      "type": "boolean",
      "description": "Trigger on issue events.",
      "example": true
    },
    "confidential_issues_events": {
      "type": "boolean",
      "description": "Trigger on confidential issue events.",
      "example": true
    },
    "merge_requests_events": {
      "type": "boolean",
      "description": "Trigger on merge request events.",
      "example": true
    },
    "note_events": {
      "type": "boolean",
      "description": "Trigger on comment events.",
      "example": true
    },
    "confidential_note_events": {
      "type": "boolean",
      "description": "Trigger on confidential comment events.",
      "example": true
    },
    "job_events": {
      "type": "boolean",
      "description": "Trigger on job status change events.",
      "example": true
    },
    "pipeline_events": {
      "type": "boolean",
      "description": "Trigger on pipeline status change events.",
      "example": true
    },
    "wiki_page_events": {
      "type": "boolean",
      "description": "Trigger on wiki page events.",
      "example": true
    },
    "deployment_events": {
      "type": "boolean",
      "description": "Trigger on deployment events.",
      "example": true
    },
    "releases_events": {
      "type": "boolean",
      "description": "Trigger on release events.",
      "example": true
    },
    "member_events": {
      "type": "boolean",
      "description": "Trigger on group member events.",
      "example": true
    },
    "push_events_branch_filter": {
      "type": "string",
      "description": "Branch name or wildcard pattern to filter push events.",
      "example": "main"
    }
  },
  "required": [
    "url"
  ]
}

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-input-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.