# Documentation about Webhook payloads

**URL:** <https://forum.gitea.com/t/documentation-about-webhook-payloads/12079>\
**Category:** Gitea Usages\
**Created:** [April 30, 2026, 8:31am UTC](https://forum.gitea.com/t/documentation-about-webhook-payloads/12079 "2026-04-30T08:31:40Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![bmwiedemann](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.gitea.com/bmwiedemann/32/7391_2.png) [@bmwiedemann](https://forum.gitea.com/u/bmwiedemann)\
**Post date:** [April 30, 2026, 8:31am UTC](https://forum.gitea.com/t/documentation-about-webhook-payloads/12079/1 "2026-04-30T08:31:40Z")

</div>

Hi, for the gitea deployment on src.opensuse org we use Webhooks quite a lot.

However, I found the documentation on [Webhooks | Gitea Documentation](https://docs.gitea.com/usage/webhooks) does not tell about which events and payloads to expect, so we referred to [Webhook events and payloads - GitHub Docs](https://docs.github.com/en/webhooks/webhook-events-and-payloads#delete) instead.

However, we noticed that there are differences, e.g. deletion of a branch does not produce a push event = github com/openSUSE/openSUSE-git/issues/361

Q: does gitea intend to follow GitHub docs (would make sense for compatibility)?

Q2: if no, is there somewhere more comprehensive documentation about Webhooks events and payloads?

P.S. had to un-link some links to make the forum software happy.

---

<div class="post-metadata">

**Author:** ![lunny](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.gitea.com/lunny/32/4701_2.png) [@lunny](https://forum.gitea.com/u/lunny)\
**Post date:** [May 1, 2026, 5:56am UTC](https://forum.gitea.com/t/documentation-about-webhook-payloads/12079/2 "2026-05-01T05:56:22Z")

</div>

I created a PR [#393](https://gitea.com/gitea/docs/pulls/393) to update the webhook documentations.