subscription_create

Subscribe to a creator and trigger initial content ingestion. This counts against your creator limit. Ingestion runs asynchronously—use ingestion_status to check progress.

Parameters

Parameter	Type	Required	Description
`platform`	string	Yes*	Platform: x, instagram, tiktok, youtube, linkedin
`handle`	string	Yes*	Creator's handle/username
`creatorId`	string (UUID)	No	Use instead of platform/handle if known
`dailyUpdates`	boolean	No	Enable daily content sync (default: false)
`postLimit`	number	No	Posts to fetch initially (1-100, default: 20)

*Either provide creatorId OR both platform and handle.

Example

Prompt

Subscribe to @naval on X and fetch 50 posts

Response

{
  "subscription": {
    "id": "sub_abc123",
    "creatorId": "550e8400-e29b-41d4-a716-446655440000",
    "status": "active",
    "dailyUpdates": false,
    "createdAt": "2024-03-15T14: <NUMBER>30</NUMBER>: <NUMBER>00</NUMBER>Z"
  },
  "creator": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "platform": "x",
    "handle": "naval",
    "displayName": "Naval"
  },
  "ingestion": {
    "jobId": "job_xyz789",
    "status": "queued",
    "postLimit": 50
  }
}

Response Fields

subscription

Field	Type	Description
`id`	string	Subscription UUID
`creatorId`	string	Associated creator
`status`	string	active or paused
`dailyUpdates`	boolean	Daily sync enabled

ingestion

Field	Type	Description
`jobId`	string	Use with ingestion_status
`status`	string	queued, running, completed, failed
`postLimit`	number	Posts requested

Common Errors

Error Code	Meaning
`already_exists`	Already subscribed to this creator
`limit_exceeded`	Creator limit reached on your plan
`not_found`	Creator not found on platform

Use Cases

Follow a new creator to track their content
Set up daily content syncing for important creators
Bulk import content from a creator's history