---
title: Getting Started with Webhooks
description: Create your first Capawesome Cloud webhook and receive a real-time event when a build, deployment, or job completes.
---

# Getting Started

Webhooks are configured per app. To create one, open **Settings → Webhooks** in your app's sidebar in the [Console](https://console.cloud.capawesome.io/){:target="_blank"} and click **Create**.

Each webhook has the following properties:

- **Name** (required) — a human-readable name to identify the webhook.
- **URL** (required) — the endpoint that receives the `POST` requests.
- **Format** (required) — `Raw` for custom integrations, or a notification format ([Slack](../integrations/slack.md), [Discord](../integrations/discord.md), [Microsoft Teams](../integrations/microsoft-teams.md)).
- **Events** (required) — one or more [events](event-types.md) that trigger the webhook.
- **Signing secret** (optional) — a secret used to [sign each request](securing.md) so the receiver can verify authenticity. Only available for the `Raw` format.

Choosing a **format** is the main decision here: pick a notification format when you just want messages in a chat channel, or `Raw` when your own backend needs to react to the event — in which case you'll also want a signing secret to [verify each request](securing.md).

!!! tip "Test before going live"

    Use [webhook.cool](https://webhook.cool/){:target="_blank"} to generate a temporary URL and inspect real payloads before pointing the webhook at your production endpoint.

Once created, trigger one of the subscribed [events](event-types.md) — for example, by starting a build — and confirm your endpoint receives the request. Every attempt is recorded in the [delivery log](delivery-and-retries.md), so you can see exactly what was sent and how your endpoint responded.

## Next steps

- [Event Types](event-types.md) — the events you can subscribe to.
- [Payload Structure](payload-structure.md) — the shape of the JSON your endpoint receives.
- [Securing Webhooks](securing.md) — verify requests with a signing secret.