Create a feed
Authorizations
Clerk API key. Create one in Settings → API Keys. Pass as Authorization: Bearer <key>. Keys carry a scope — read, write (implies read) or admin (implies write) — chosen when the key is minted. Each operation's security requirement (and its x-required-scope extension) names the minimum scope it needs; request the least-privileged key that covers the operations you call.
Body
Create a new feed. Pass either simpleFilters or advancedFilters (or neither for a match-all feed). At most 50 conditions may be stored across both filter sides.
Feed display name. Max 191 characters, no control characters.
1 - 191Icon identifier for UI display (Heroicons outline set).
InboxStackIcon, HeartIcon, AtSymbolIcon, ExclamationTriangleIcon, MegaphoneIcon, ArrowTrendingUpIcon, BuildingOffice2Icon, ArrowTrendingDownIcon, BellIcon, BuildingLibraryIcon, BugAntIcon, ChartBarIcon, ChatBubbleLeftIcon, ChatBubbleLeftRightIcon, CheckCircleIcon, CloudIcon, CodeBracketIcon, ComputerDesktopIcon, CubeIcon, CurrencyDollarIcon, CursorArrowRaysIcon, DevicePhoneMobileIcon, DocumentIcon, DocumentTextIcon, EnvelopeIcon, EyeIcon, FaceSmileIcon, FaceFrownIcon, FireIcon, FlagIcon, FolderIcon, GlobeAltIcon, GlobeAmericasIcon, HandThumbUpIcon, HashtagIcon, InboxArrowDownIcon, LightBulbIcon, PaperClipIcon, RectangleStackIcon, RocketLaunchIcon, RssIcon, SignalIcon, SparklesIcon, StarIcon, TagIcon, TrophyIcon, UserGroupIcon, WalletIcon "BellIcon"
Simple AND-combined filter list.
Nested filter expression — groups of conditions combined with AND/OR.
Notification targets. Omit for a filter-only feed.
Response
200 response
A saved filter with optional notification destinations.
Feed ID.
-9007199254740991 <= x <= 9007199254740991Display name shown in the app and included in notifications.
"Competitor mentions"
Icon identifier for UI display (Heroicons outline set).
InboxStackIcon, HeartIcon, AtSymbolIcon, ExclamationTriangleIcon, MegaphoneIcon, ArrowTrendingUpIcon, BuildingOffice2Icon, ArrowTrendingDownIcon, BellIcon, BuildingLibraryIcon, BugAntIcon, ChartBarIcon, ChatBubbleLeftIcon, ChatBubbleLeftRightIcon, CheckCircleIcon, CloudIcon, CodeBracketIcon, ComputerDesktopIcon, CubeIcon, CurrencyDollarIcon, CursorArrowRaysIcon, DevicePhoneMobileIcon, DocumentIcon, DocumentTextIcon, EnvelopeIcon, EyeIcon, FaceSmileIcon, FaceFrownIcon, FireIcon, FlagIcon, FolderIcon, GlobeAltIcon, GlobeAmericasIcon, HandThumbUpIcon, HashtagIcon, InboxArrowDownIcon, LightBulbIcon, PaperClipIcon, RectangleStackIcon, RocketLaunchIcon, RssIcon, SignalIcon, SparklesIcon, StarIcon, TagIcon, TrophyIcon, UserGroupIcon, WalletIcon "BellIcon"
A persisted simple filter, including legacy rows above current write limits.
A persisted advanced filter expression, including legacy rows above current write limits.
If true, this feed is pinned as the org's default view.
Notification destinations. Empty array = filter-only feed with no notifications.
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$