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

# NetBird Webhook Setup Guide

> Configure NetBird to deliver events to StackOne.

## Prerequisites

The connector should already be set up, with a Connector Profile and a Linked Account. See [Getting Started](https://docs.stackone.com/connectors/netbird.md#getting-started) on the NetBird connector page.

## Programmatic Webhooks

This connector uses **Programmatic Webhooks**. StackOne creates the NetBird webhook when you connect the account and deletes it when you disconnect. You do not set anything up in NetBird.

**1. Select the events in StackOne**

Open the NetBird connector profile in StackOne and enable the events you want. See **Available webhook events** below.

**2. Check the webhook in NetBird**

In NetBird, open **Settings** -> **Notifications** -> **Webhook**. It shows the StackOne callback URL and the enabled events. Do not delete it, or events stop arriving.

![NetBird Settings > Notifications > Webhook page with the StackOne callback URL and the event switches](https://mintcdn.com/stackone-60/JOp4ox7pIfGhfdq9/connectors/netbird/images/events-notifications-webhook.png?fit=max\&auto=format\&n=JOp4ox7pIfGhfdq9\&q=85\&s=b078e0840141e1c9b22a4c79593e46bc)

## Available webhook events

Only the events you enable in StackOne are delivered.

**1. Peer events**

Events about devices (peers) on your network.

<ul>
  <li>**Peer Added** (`peer.add`) — Fired when a new peer is added to the network</li>
  <li>**Peer Pending Approval** (`peer.pending.approval`) — Fired when a peer is waiting for approval to join the network</li>
  <li>**Routing Peer Disconnected** (`routing.peer.disconnect`) — Fired when a routing peer loses its connection</li>
  <li>**Routing Peer Deleted** (`routing.peer.delete`) — Fired when a routing peer is deleted from the network</li>
</ul>

**2. User events**

Events about people and service users.

<ul>
  <li>**User Joined** (`user.join`) — Fired when a new user joins the account</li>
  <li>**User Pending Approval** (`user.pending.approval`) — Fired when a user is waiting for approval to join the network</li>
  <li>**Service User Created** (`service.user.create`) — Fired when a new service user is created</li>
</ul>

**3. Integration events**

Events about identity provider and EDR sync integrations.

<ul>
  <li>**IdP Sync Token Expired** (`idp.sync.token.expire`) — Fired when the identity provider sync token expires and needs renewal</li>
  <li>**EDR Sync Token Expired** (`edr.sync.token.expire`) — Fired when the EDR sync token expires and needs renewal</li>
</ul>

## Verify

Your Connector should now be able to receive and process events. Try triggering an event and you should see an Event appear in the Connector logs.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.