diff --git a/doc/using_webhooks.rst b/doc/using_webhooks.rst
index a31dd48..72275fd 100644
--- a/doc/using_webhooks.rst
+++ b/doc/using_webhooks.rst
@@ -11,3 +11,18 @@ enter the URL to the server that will receive the notifications.
 In the settings page is also present a web-hook key which is used by the
 server to sign the message sent and which you can use to ensure the
 notifications received are coming from the right source.
+
+Each POST request made contains two specific headers:
+
+::
+
+    X-Pagure-Topic
+    X-Pagure-Signature
+
+
+``X-Pagure-Topic`` is a global header giving a clue about the type of action
+that just occured. For example ``issue.edit``.
+
+
+``X-Pagure-Signature`` contains the signature of the message allowing to
+check that the message comes from pagure.