Skip to main content
POST
Create a content listener

Authorizations

Authorization
string
header
required

API key prefixed with cr_ (e.g. cr_a1b2c3...)

Query Parameters

website_id
string<uuid>

Website ID. Auto-resolved if key has single website scope.

Body

application/json
name
string
required

Human-readable label for this listener

source_type
enum<string>
required

External source to monitor

Available options:
reddit,
youtube,
google_news,
google_search,
rss,
linkedin,
x,
pinterest,
quora
query_config
object

Source-specific query parameters (subreddit, keywords, RSS URL, etc.)

poll_interval
enum<string>
default:12h

How often to poll the source for new items

Available options:
1h,
6h,
12h,
24h,
7d

Response

Listener created

success
boolean
required
data
object