Sources

Create or return an RSS, YouTube, X profile, or email source

Create or return an RSS, YouTube, X profile, or email source.

post/api/sources

Request

  • Base URL: https://keep.md
  • URL: https://keep.md/api/sources
  • Auth: one of:
    • HTTP bearer
    • API key in cookie keep.session_token

Headers

Keep-API-Versionstring
Example:2026-08-24

Optional date-based Keep API version. Omit it to use the current version.

Request body

type'rss' | 'youtube_channel' | 'x_articles' | 'email_inbox' | 'web_monitor' required
urlstring uri

Required for web_monitor. Public webpage or sitemap URL.

kind'page' | 'sitemap'

Required for web_monitor. Checks daily; first capture silently establishes a baseline. Maximum 10 monitors per account.

namestring
pollEveryMininteger
feedUrlstring uri
channelstring
channelIdstring
handlestring
inputstring
usernamestring
contentMode'posts' | 'articles' | 'both'
backfillMode'from_now' | 'days' | 'articles'
backfillDaysinteger
backfillItemsinteger
initialImportCountinteger
rollupEnabledboolean
expandFullContentboolean
autoSummarizeboolean
defaultTagsstring[]

Response

Created or existing source

existingboolean
initialRunobject
discoveryobject

Changes

No recorded changes to this operation across all 1 revision of this API.