OpsTrailsDocs
Console

Webhooks

Receive events automatically from your Git platform via webhooks. OpsTrails supports GitHub, GitLab, and Bitbucket webhooks out of the box.

📝 Note

Replace YOUR_ORG_ID with your organization ID and YOUR_WEBHOOK_SECRET with a shared secret for signature verification. Both are available in the console.

GitHub

Go to your repository's Settings → Webhooks → Add webhook and configure:

Payload URL: https://api.opstrails.dev/api/v1/webhooks/github?org=YOUR_ORG_ID&secret=YOUR_WEBHOOK_SECRET
Content type: application/json
Events: deployment, deployment_status

GitLab

Go to your project's Settings → Webhooks and configure:

URL: https://api.opstrails.dev/api/v1/webhooks/gitlab?org=YOUR_ORG_ID&secret=YOUR_WEBHOOK_SECRET
Trigger: Deployment events
Secret token: (uses X-Gitlab-Token header for verification)

Bitbucket

Go to your repository's Settings → Webhooks → Add webhook and configure:

URL: https://api.opstrails.dev/api/v1/webhooks/bitbucket?org=YOUR_ORG_ID&secret=YOUR_WEBHOOK_SECRET
Events: repo:commit_status_created, repo:commit_status_updated