Webhooks

Automations use webhooks to receive Git events from your provider. When you create an automation, Capawesome Cloud automatically registers a webhook on your connected Git repository. If automatic registration fails, you can configure the webhook manually.

Automatic Setup

When you create an automation, Capawesome Cloud attempts to register a webhook on your Git repository automatically. If the registration succeeds, no further action is needed — the webhook is ready to receive events.

Manual Setup

In some cases, automatic webhook registration may fail — for example, due to insufficient permissions or when using a self-hosted Git provider. In these cases, you can configure the webhook manually using the values provided in the Setup dialog.

Access the Setup Dialog

To access the Setup dialog, navigate to the Automations page of your app in the Capawesome Cloud Console and click the Setup button. The dialog displays two values:

• Webhook URL: The endpoint that receives Git events from your provider.
• Webhook Secret: A secret used to verify incoming webhook payloads.

Both values have copy-to-clipboard buttons for convenience.

Configure Your Git Provider

Add a new webhook in your Git provider's settings using the Webhook URL and Webhook Secret from the Setup dialog. The webhook should be configured to send push events.

For provider-specific instructions on adding webhooks, refer to the following documentation:

• GitHub
• GitLab
• Bitbucket
• Azure DevOps

Verifying the Webhook

To confirm that the webhook is working correctly:

1. Push a commit or create a tag that matches one of your automation's trigger patterns.
2. Navigate to the Automations page and check that the automation's Last triggered timestamp has updated.
3. Navigate to the Builds page and verify that a new build was created.