---
title: Webhooks for Build and Deployment Events
description: Receive real-time webhook notifications for builds, deployments, and jobs in Capawesome Cloud. Integrate with CI/CD, Slack, and custom backends.
---

# Webhooks

Webhooks let you receive real-time notifications when events occur in your app. When an event is triggered, Capawesome Cloud sends an HTTP `POST` request to your configured endpoint — enabling integrations with CI/CD pipelines, chat tools, or custom backends.

!!! info "Outbound vs inbound"

    These are **outbound** webhooks (Capawesome Cloud → your endpoint). They are not the same as the inbound Git webhook used by [Automations](../automations/webhooks.md) to receive events from your Git provider.

## Formats

Each webhook has a **format** that controls the payload:

- **Raw** — a JSON payload for custom integrations and backends. Supports [signing](securing.md) for verification.
- **Notification formats** — pre-formatted messages for [Slack](../integrations/slack.md), [Discord](../integrations/discord.md), and [Microsoft Teams](../integrations/microsoft-teams.md).

## Documentation

- [Get Started](setup.md) — create a webhook and receive your first event.
- [Event Types](event-types.md) — the events you can subscribe to.
- [Payload Structure](payload-structure.md) — the shape of the JSON payload.
- [Securing Webhooks](securing.md) — verify signatures.
- [Delivery & Retries](delivery-and-retries.md) — delivery history and resending.
- [Best Practices](best-practices.md).

## Bonus: Video Walkthrough

<div style="margin-top: 1rem;">
  <iframe
    width="100%"
    height="450px"
    src="https://www.youtube-nocookie.com/embed/gB2p9igksmY?rel=0&modestbranding=1"
    frameborder="0"
    allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
    referrerpolicy="strict-origin-when-cross-origin"
    allowfullscreen
  ></iframe>
</div>