Global Webhooks

The enterprise expansion pack provides support for global webhooks for internal system events. Notification are sent as HTTP POST requests to an endpoint of your choosing.

Example server configuration:

services:
  drone-server:
    image: drone/drone:0.7
    environment:
+     - DRONE_HOOK=http://localhost:4567/payload

Webhook requests are triggered for the following event types:

Name Description
user any time a user is created or deleted
repo any time a repository is created or updated
build any time a build is created or updated

Webhook requests contain the following special headers:

Header Description
X-Drone-Event name of the event that triggered this delivery

Example delivery:

POST /payload HTTP/1.1

Host: localhost:4567
Content-Type: application/json
Content-Length: 100
X-Drone-Event: user

{
  "action": "created",
  "user": {
    "id": 1,
    "login": "johnsmith",
    "active": true
  }
}