Skip to main content
POST
Create a new feed

Authorizations

Authorization
string
header
required

API key prefixed with jcr_. To obtain a key programmatically (no dashboard required), see POST /v1/authorize.

Body

application/json
name
string
required

Feed name

Example:

"My Brand Feed"

sync_interval
integer | null

How often the feed's sources are synced, in minutes. Allowed values are the standard sync frequencies 1, 5, 10, 30, 60, 240, and 1440 (once a day). Use 0 to archive the feed (stop updating it). Omit the field or send null to use your plan's default sync frequency (once a day on most plans). Setting it requires a plan that supports per-feed sync frequency; on other plans the request returns 422 with error.code = "sync_interval_not_available". On credit-metered API plans an invalid value is rejected with 422 (error.code = "invalid_sync_interval"). On credit-metered API plans each successful sync of a metered source consumes API credits, so a faster interval consumes credits proportionally faster (an hourly feed spends roughly 24x what a daily feed does); when the balance runs out the feed's sources pause until it is topped up.

Example:

60

Response

Feed created

data
object