> ## Documentation Index
> Fetch the complete documentation index at: https://meetbit.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# MeetBit Webhooks

> Learn how to utilize webhooks from MeetBit

MeetBit webhooks let your system receive real-time updates for key events. Register an endpoint, and MeetBit will send HTTP POST requests with event data, enabling automated workflows and instant responses.

## General Flow

```mermaid theme={null}
sequenceDiagram
autonumber

participant M as MeetBit Platform
participant U as Your System

note over M: Event Occurs

M->>U: POST Request
note over U: Verify Request
U->>M: 200 OK

note over U: Async Processing

opt
U->>M: Public API Request
M->>U: Response
end

```

In general, webhooks are sent by MeetBit via POST requests<sup>1</sup> to your system after a certain event occurs within the MeetBit Platform (e.g. Meeting Link is scheduled). Your system is then expected to **respond immediately**<sup>2</sup> before processing the event asynchronously. Since data being sent along with the initial POST request is generally kept to a minimum, making requests to the MeetBit Public API<sup>3</sup> is a common part of this processing.

## Setup

To start receiving webhooks, you have to first register your endpoint as a Webhook Destination in the MeetBit Admin Panel.

<Warning>
  You must have the permission to create, read and activate webhook destinations to perform the actions below.
</Warning>

<Steps>
  <Step title="Open Create Webhook Destination Page">
    From the Webhook Destinations Page (`/admin/webhook_destinations`), click the "Create" button on the upper right corner.
  </Step>

  <Step title="Provide Details">
    On the Create Webhook Destination Page, provide the destination's name, url (must be HTTPS) and the events the destination is subscribing to. Then, click "Create".
  </Step>

  <Step title="HMAC Secret">
    Once created, you are able to view the destination's HMAC secret. This is used for the security and explain in [a dedicated section](/webhooks/security).
  </Step>

  <Step title="Activating the Destination">
    Once your endpoint is ready to accept requests, you can activate the destination.
  </Step>
</Steps>

## Next Steps

Before you activate your destination, check the other sections to learn more about using MeetBit Webhooks.

<CardGroup cols={2}>
  <Card title="Handling Requests" icon="webhook" href="/webhooks/handling">
    Understand how to handle webhooks sent by MeetBit
  </Card>

  <Card title="Webhook Security" icon="lock" href="/webhooks/security">
    Properly secure your webhook endpoints
  </Card>

  <Card title="Available Events" icon="bell" href="/webhooks/events">
    The available events that trigger webhooks
  </Card>
</CardGroup>
