All guides

Webhooks guide

Test GitLab webhooks and inspect delivery payloads

GitLab can send a selected test event from the webhook settings page. PNTR gives that delivery a stable public destination and keeps the full request visible while you build the receiver.

Explore PNTR's online webhook tester

Webhook URL

https://yourname.pntr.dev/gitlab

Setup

  1. 1

    Create the capture URL

    Create a PNTR subdomain with request capture enabled and copy a URL such as https://yourname.pntr.dev/gitlab.

  2. 2

    Open the project webhook settings

    In GitLab, open the project, then Settings and Webhooks. Project webhooks require the Maintainer or Owner role.

  3. 3

    Register only the events you need

    Paste the PNTR URL and select the event types your application consumes, such as push or merge request events. Use GitLab's signing option where your version supports it.

  4. 4

    Send a GitLab test event

    From the configured webhook's Test menu, choose an available event. A push-event test requires the project to contain at least one commit.

  5. 5

    Compare both delivery views

    Inspect the body and X-Gitlab-Event metadata in PNTR, then use GitLab's Recent events details to compare the sent request and received response or resend the same delivery.

Before you ship

PNTR returns 200 after storing a request, which verifies delivery but not your application logic. In the final handler, verify GitLab's configured signing credential and make processing safe for repeated deliveries.

Primary documentation