---
title: "Create a feed subscription"
method: POST
path: "/feeds/subscriptions"
tags: ["Feeds"]
---

# Create a feed subscription

`POST /feeds/subscriptions`

Links a feed to a schedule template (ClientRequest) so that new feed items trigger automated content generation.

## Request body

- object
  - `feedId` integer, required — Identifier of the feed to subscribe to.
  - `requestId` string, required — Schedule template (ClientRequest) to clone when new items arrive.
  - `lastProcessedItemId` string — Optional feed item identifier to mark as already processed.

## Response `201`

Subscription created successfully

- FeedSubscription
  - `id` string, uuid — Unique identifier for the subscription
  - `feedId` integer — Identifier of the subscribed feed
  - `token` string — Token that owns the subscription
  - `requestId` string — ClientRequest template identifier used for automation
  - `createdOn` string, date-time — When the subscription was created
  - `removedOn` string, date-time, nullable — When the subscription was removed, if applicable
  - `lastProcessedItemId` string, nullable — Identifier of the last feed item processed for this subscription
  - `lastProcessedOn` string, date-time, nullable — Timestamp of the last processed feed item
  - `request` object, nullable — Snapshot of the underlying template request

## Other responses

- `400` — Validation error
- `404` — Feed or template not found
- `409` — Subscription already exists for this feed/template pair
- `500` — Internal server error during creation

---

[API](https://skmtc.net/autocontentapi/apis/content-api.md) · [All operations](https://skmtc.net/autocontentapi/apis/content-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/autocontentapi/content-api/revisions/355890b6b4cc/schema)