RSS Feeds

Permission: posts.read. See Roles and permissions.

Listing and reading feeds and their items need posts.read. Creating, previewing, updating, pausing, resuming, checking and deleting need posts.draft, plus the permission the feed's post mode needs: posts.schedule for SCHEDULE, posts.publish for PUBLISH, and ai.generate for AI captions. A feed another member set up also needs posts.others to update, pause, resume, check or delete.

A feed is checked on a schedule, and each item that appears after you added it becomes a post on the accounts in targets. Every post goes through the same checks as Create Post. A feed posts as the member who last saved it: creating, updating or resuming a feed makes the key's member its owner.

POST /api/v1/rss-feeds

Fetches the feed and records every item already in it, so only items that appear later are posted. A workspace holds up to 20 feeds.

Targets can be FACEBOOK, INSTAGRAM, THREADS, TWITTER, BLUESKY, LINKEDIN, MASTODON, TELEGRAM and GOOGLE_BUSINESS.

Example request:

{
  "url": "https://blog.example.com/feed.xml",
  "targets": [
    { "platform": "LINKEDIN", "connectionId": "conn_li_001" },
    { "platform": "FACEBOOK", "connectionId": "conn_fb_001", "pageId": "123456789012345" }
  ],
  "postMode": "SCHEDULE",
  "publishDelayMinutes": 30,
  "contentMode": "TEMPLATE",
  "template": "New on the blog: {title}\n\n{link}",
  "excludeKeywords": ["sponsored"]
}

Returns 201 with the feed:

{
  "id": "rss_01j9x",
  "userId": "user_123",
  "accountGroupId": "ag_01j9x",
  "name": "Example Blog",
  "url": "https://blog.example.com/feed.xml",
  "siteUrl": "https://blog.example.com",
  "status": "ACTIVE",
  "postMode": "SCHEDULE",
  "publishDelayMinutes": 30,
  "contentMode": "TEMPLATE",
  "template": "New on the blog: {title}\n\n{link}",
  "includeImage": true,
  "twitterKeepLinks": false,
  "includeKeywords": [],
  "excludeKeywords": ["sponsored"],
  "maxPostsPerCheck": 3,
  "checkIntervalMinutes": 60,
  "targets": [
    { "platform": "LINKEDIN", "connectionId": "conn_li_001", "displayName": "Example Inc." },
    { "platform": "FACEBOOK", "connectionId": "conn_fb_001", "pageId": "123456789012345", "displayName": "Example" }
  ],
  "nextCheckAt": "2026-11-08T15:00:00.000Z",
  "createdAt": "2026-11-08T14:00:00.000Z",
  "updatedAt": "2026-11-08T14:00:00.000Z"
}

A URL that is not an RSS or Atom feed, a feed already connected, an unsupported target platform, a missing publishDelayMinutes or the 20 feed limit returns 400. A feed that cannot be reached returns 503. A key without the permission the post mode or AI captions need returns 403.

Feed fields

The other fields carry the settings above.

Fix the cause, then resume the feed.

POST /api/v1/rss-feeds/preview

Takes url and an optional template, fetches the feed without saving anything, and returns url, title, siteUrl and its 5 newest items, each with title, link, summary, publishedAt, imageUrl and text, the item rendered with the template.

GET /api/v1/rss-feeds/:id/items

Lists the items the feed has seen, newest first, leaving out the ones that were already in the feed when it was added. limit takes 1 to 100 and defaults to 20. Returns { "items": [...] }, each with id, title, link, publishedAt, createdAt, status, postId and error.

Update, pause, resume, check and delete

PATCH takes the same fields as create, except url and postLatestItem, and changes only the ones you send. Pause, resume, check and delete take no body. Each of them except delete returns the feed; delete returns { "deleted": true }. An id that does not exist or belongs to another workspace returns 404.