> For the complete documentation index, see [llms.txt](https://docs.economize.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.economize.cloud/integrations/zulip.md).

# Zulip

Follow the below steps to integrate Zulip with Economize, allowing you to receive configured [notifications](/product-features/notifications.md) in your preferred stream.

1. **Create a Zulip account:**

* Go to the Zulip website (<https://zulip.com/>) and create an account.
* After creating the account, log in to your Zulip account.

2. **Create a Zulip Stream:**

* In Zulip, streams are used to organize conversations around specific topics. Therefore, you need to create a stream in Zulip that will be used to receive notifications from Economize.
* Click on the gear icon on the top right corner of the Zulip interface, and select `Manage Streams`.

<figure><img src="/files/TcFraLM8mxdsHrB6VIV7" alt=""><figcaption></figcaption></figure>

* Click on the `Create Stream` button and give the stream a name (e.g., Economize).

<figure><img src="/files/lEPKZcDcuO9nF7Hzp2lH" alt=""><figcaption></figcaption></figure>

* Once the stream is created, note down the name of the stream as it will be used in the integration process.

3. **Obtain Zulip Email and API Key:**

* To send messages to the Zulip stream, you will need to use the Zulip Email and API key.
* In Zulip, click on the gear icon on the top right corner of the Zulip interface, and select `Settings`.
* Scroll down to the `Personal settings` section and navigate to the `Bots` section.

<figure><img src="/files/aEFDBdr1GIHFPz2tyTHj" alt=""><figcaption></figcaption></figure>

* You can create a new bot or use an existing one as per your liking.
* Copy the `Bot Email` & `API Key` as it will be needed later

4. **Configure Economize:**

* Log in to your Economize account and navigate to `Settings -> Integrations`.
* In the Integrations settings, click on `Manage Integration` for Zulip.

<figure><img src="/files/tMKLL5dN2By0ndkcrkwY" alt=""><figcaption></figcaption></figure>

* You will be presented with existing Zulip Streams which have been added before, in order to add a new one, simply click on `Add Zulip Integration` button.

<figure><img src="/files/NghnZORJ4WZRmknK2ZwD" alt=""><figcaption></figcaption></figure>

* Enter the Zulip Email, Zulip API key, and the Zulip stream name you created earlier in the respective fields.

<figure><img src="/files/YPbetZEUQXVieF5TiVKY" alt=""><figcaption></figcaption></figure>

* Enter the Zulip URL (e.g., <https://sample-org.zulipchat.com/api/v1/messages>) in the URL field.
* Click on the **Connect** button.
