POST /feeds
Subscribe to a feed and import its recent articles. Accepts a feed URL or a site homepage — the feed is resolved either way. Confirm the source with the user first unless they named it explicitly.
Held in this tab only (sessionStorage) and sent to the base URL above. Closing the tab clears it.
Parameters
Section titled “Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
url | string | yes | Feed URL or site homepage. |
folder_id | string | no | Folder to file it under, e.g. “fld_abc123”. |
name | string | no | Override the feed title. |
allow_scrape | boolean | no | Allow a verified Website source when no native feed exists. |
Responses
Section titled “Responses”| Status | Meaning |
|---|---|
200 | Add feed |
400 | Invalid or missing parameters. |
401 | Missing or invalid API key. |
403 | The key lacks the “feeds:write” scope. |
429 | Rate limit exceeded. See Retry-After. |
Requires the feeds:write scope.