Skip to Content

Webhooks

Git webhook endpoints for automatic deployments on push. These endpoints are called by GitHub, GitLab, or Bitbucket when code is pushed to a repository.

Endpoints

MethodPathAuthDescription
POST/api/v1/webhooks/githubSignatureGitHub push events
POST/api/v1/webhooks/gitlabTokenGitLab push events
POST/api/v1/webhooks/bitbucketSignatureBitbucket push events

These endpoints do not use standard API authentication. Instead, they verify requests using provider-specific mechanisms:

ProviderVerification
GitHubX-Hub-Signature-256 header (HMAC-SHA256)
GitLabX-Gitlab-Token header (shared secret)
BitbucketX-Hub-Signature header (HMAC-SHA256)

Webhook URLs are automatically generated when you create an application with autodeploy: true and a git source. The webhook secret is stored securely and used to verify incoming requests.

Last updated on