---
title: Zulip
description: Connect Honeybadger to Zulip to receive real-time application monitoring alerts directly in your team's streams.
url: https://docs.honeybadger.io/guides/integrations/zulip/
---

Users with administrative privileges can find this integration below the list of personal alert integrations on the Alerts & Integrations tab of the Project Settings page.

## Setup

### 1. In Zulip, create a new incoming webhook bot.

You’ll need to create a new Incoming Webhook Bot in Zulip. This is done by going to the **Settings** page of your Zulip organization and selecting **Bots** from the left-hand menu.

![zulip incoming webhook](https://docs.honeybadger.io/_astro/zulip_incoming_webhook.BNl3bYqQ_ZN5wfd.webp)

### 2. In Honeybadger, locate the Zulip integration.

In the project settings, click on the **Integrations** tab where you’ll find the Zulip integration.

![zulip integration](https://docs.honeybadger.io/_astro/zulip_integration.BHJN9itz_2tfUl9.webp)

### 3. Fill in the required fields and save.

Fill in the bot email and API key which you generated in step 1, along with the channel and topic where notifications should be posted. Then tell Honeybadger where your Zulip organization lives:

* **Zulip Cloud**: enter your organization’s subdomain in the **Zulip Cloud subdomain** field (for example, `example` for `example.zulipchat.com`), and leave **Server URL** blank.
* **Self-hosted Zulip**: enter your server’s address in the **Server URL** field (for example, `https://chat.example.com`), and leave **Zulip Cloud subdomain** blank. When a server URL is set, it’s used instead of the Zulip Cloud subdomain.

The server URL must use HTTPS, must be just the server’s address (no path, query string, or credentials), and must resolve to a publicly reachable address.

Configure which notifications you wish to receive and then save.

You can also click on the “Test this integration” button to send a test notification to your Zulip stream. This is a great way to ensure that everything is set up correctly before you start receiving real notifications.

![zulip notification](https://docs.honeybadger.io/_astro/zulip_notification.oeKSD_Do_Z1rGcUp.webp)

---

## Try Honeybadger for FREE

Intelligent logging, error tracking, and Just Enough APM™ in one dev-friendly platform. Find and fix problems before users notice.

[Start free trial](https://app.honeybadger.io/users/sign_up)

[See plans and pricing](https://www.honeybadger.io/plans/)
