---
title: "Creates a SideNav Stream from a SmartFilter and adds it to the user's sidenav as visible"
method: POST
path: "/api/Stream/add-sidenav-stream-from-external-source"
tags: ["Stream"]
---

# Creates a SideNav Stream from a SmartFilter and adds it to the user's sidenav as visible

`POST /api/Stream/add-sidenav-stream-from-external-source`

## Request

- Base URL: `http://localhost:5000`
- URL: `http://localhost:5000/api/Stream/add-sidenav-stream-from-external-source`
- Auth: API key in header `x-api-key`

## Query parameters

- `externalSourceId` integer

## Response `200`

OK

- SideNavStreamDto
  - `id` integer
  - `name` string, nullable, required
  - `isProvided` boolean
  - `order` integer
  - `smartFilterEncoded` string, nullable
  - `smartFilterId` integer, nullable
  - `externalSourceId` integer
  - `externalSource` ExternalSourceDto
    - `id` integer, required
    - `name` string, nullable, required
    - `host` string, nullable, required
    - `apiKey` string, nullable, required
  - `streamType` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9: Members: - `1` — Collections - `2` — ReadingLists - `3` — Bookmarks - `4` — Library - `5` — SmartFilter - `6` — ExternalSource - `7` — AllSeries - `8` — WantToRead - `9` — BrowsePeople
  - `visible` boolean
  - `libraryId` integer, nullable
  - `library` LibraryDto
    - `id` integer
    - `name` string, nullable
    - `type` 0 | 1 | 2 | 3 | 4 | 5: Members: - `0` — Manga - `1` — Comic (Flexible) (Comic) - `2` — Book - `3` — Image - `4` — Light Novel (LightNovel) - `5` — Comic (ComicVine)
    - `lastScanned` string, date-time
    - `coverImage` string, nullable
    - `folderWatchMode` 0 | 1 | 2 | 3: Members: - `0` — Off - `1` — Automatic - `2` — File Watcher (FileWatcher) - `3` — Polling
    - `includeInDashboard` boolean
    - `includeInRecommended` boolean
    - `manageCollections` boolean
    - `manageReadingLists` boolean
    - `includeInSearch` boolean
    - `allowScrobbling` boolean
    - `folders` string[], nullable
    - `collapseSeriesRelationships` boolean
    - `libraryFileTypes` FileTypeGroup[], nullable
    - `excludePatterns` string[], nullable
    - `allowMetadataMatching` boolean
    - `enableMetadata` boolean
    - `removePrefixForSortName` boolean
    - `inheritWebLinksFromFirstChapter` boolean
    - `defaultLanguage` string, nullable
    - `metadataProvider` 2 | 3 | 4: Members: - `2` — Hardcover - `3` — Mangabaka - `4` — ComicBookRoundup
  - `entityType` 0 | 1 | 2 | 3: Members: - `0` — Series - `1` — Reading List (ReadingList) - `2` — Person - `3` — Annotation

## Changes

- **2026-10-22** `7de671750636`: 3 warning, 3 info
  - removed the optional property `library/folderWatching` from the response with the `200` status (media type: text/plain)
  - removed the optional property `library/folderWatching` from the response with the `200` status (media type: application/json)
  - removed the optional property `library/folderWatching` from the response with the `200` status (media type: text/json)
  - added the optional property `library/folderWatchMode` to the response with the `200` status (media type: text/plain)
  - …2 more
- **2026-08-13** `3bd8363f0a4e`: 3 info
  - added the optional property `library/metadataProvider` to the response with the `200` status (media type: text/plain)
  - added the optional property `library/metadataProvider` to the response with the `200` status (media type: application/json)
  - added the optional property `library/metadataProvider` to the response with the `200` status (media type: text/json)
- **2026-04-18** `58caf8bfeda1`: 3 info
  - added the optional property `entityType` to the response with the `200` status (media type: text/plain)
  - added the optional property `entityType` to the response with the `200` status (media type: application/json)
  - added the optional property `entityType` to the response with the `200` status (media type: text/json)
- …earlier changes not shown

[Operation history](https://skmtc.dev/kareadita/apis/kavita/changes/api/Stream/add-sidenav-stream-from-external-source/post.md)

---

[API](https://skmtc.dev/kareadita/apis/kavita.md) - [All operations](https://skmtc.dev/kareadita/apis/kavita/llms.txt) - [OpenAPI document](https://skmtc.dev/kareadita/apis/kavita/revisions/d266465eeb67?raw)