COcontentstudio
🔁 RSS Automations

Create an RSS automation

Changed on

Creates an RSS feed automation that posts new feed items to the selected accounts. The feed URL is fetched and validated before the automation is saved, so an unreachable feed fails the request. Counts against the workspace's automation plan limit.

post/api/v1/workspaces/{workspace_id}/automations/rss

Request

  • Base URL
    https://api.contentstudio.io
  • URL
    https://api.contentstudio.io/api/v1/workspaces/{workspace_id}/automations/rss
  • Auth
    API key in header X-API-Key

Path parameters

workspace_idstring required
Example:610a1e660cb41530ca40d372

Workspace ID

Request body

namestring required
account_selectionobject required

Platform => account ids the automation posts to. Ids are the id GET /accounts returns (the platform identifier); any other value is refused with 422 INVALID_ACCOUNT_ID.

feed_urlstring uri required
posting_type'Immediately' | 'Queue' | 'content_category' required

What happens to each new feed item: Immediately publishes it, Queue adds it to each account's queue (see queue_slot_option), content_category files it under content_category_id (required then). Case-sensitive.

max_postinteger required

Maximum items published per pull

review_contentboolean required

Queue items for review instead of publishing straight away

content_category_idstring nullable
add_link_first_commentboolean nullable
add_source_in_descriptionboolean nullable

Append the feed item's source to the post

post_variations'body_content' | 'post_title' | 'meta_description' nullable

Which part of the feed item becomes the post body: body_content (AI-generated caption when credits allow), post_title (title + URL) or meta_description

queue_slot_option'top' | 'bottom' nullable

Where in the account queue new items land

pull_frequency'5m' | '15m' | '30m' | '1h' | '3h' | '6h' | '12h' | '24h'

How often the feed is checked. Defaults to 30m.

Example request

{
  "name": "Company blog",
  "account_selection": {
    "facebook": [
      "1329910333529595"
    ],
    "instagram": [
      "17841453340834745"
    ]
  },
  "feed_url": "https://example.com/feed.xml",
  "posting_type": "Queue",
  "max_post": 5,
  "review_content": true,
  "post_variations": "body_content",
  "pull_frequency": "30m"
}

Response

Automation created

statusboolean
messagestring
dataobject

The created RSS automation. lock is 1 while the first feed pull runs (a few seconds); status changes and updates answer 409 AUTOMATION_LOCKED until it clears.

Example response

{
  "status": true,
  "data": {
    "_id": "6ab10a1159c890e5c8014593",
    "name": "Company blog",
    "feed_url": "https://example.com/feed.xml",
    "workspace_id": "610a1e660cb41530ca40d372",
    "status": 1,
    "lock": 1,
    "posted_count": 0,
    "posting_type": "queue",
    "pull_frequency": "1h",
    "max_post": 5,
    "review_content": true,
    "post_variations": "body_content",
    "account_selection": {
      "facebook": [
        {
          "_id": "6a742f84f67707aac00bc6e3",
          "type": "Page",
          "facebook_id": "1329910333529595",
          "name": "Company page"
        }
      ]
    },
    "created_at": "2026-09-21T10:15:33.000000Z"
  }
}

Changes