n8n Operations Reference | SocialRails Documentation

All available operations for the SocialRails n8n community node.

Post — Create

Create a new social media post (draft or scheduled).

Field	Type	Required	Description
Content	string	Yes	Post text (max 5,000 chars)
Platform	select	Yes	Target platform
Schedule For	dateTime	No	ISO 8601 date (omit for draft)
Media	string[]	No	R2 keys from media upload
Platform Settings	json	No	Platform-specific overrides

Output example:

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "content": { "all": "Hello from n8n!" },
    "platform": "twitter",
    "status": "scheduled",
    "scheduled_for": "2026-03-15T14:30:00Z"
  }
}

Post — List

List posts with optional filters.

Field	Type	Description
Status	select	Filter: scheduled, posted, draft, failed
Platform	select	Filter by platform
Limit	number	Results per page (1-100, default 50)
Sort	select	Sort by created_at or scheduled_for
From / To	dateTime	Date range filter

Analytics — Get

Retrieve posting analytics for your workspace.

Field	Type	Description
Period	select	7d, 30d, 90d, or 365d
Platform	select	Filter by platform
Post ID	string	Analytics for a specific post

AI — Generate

Generate AI-powered social media content. Costs 2 AI credits per request.

Field	Type	Required	Description
Prompt	string	Yes	What to generate (max 2,000 chars)
Platform	select	No	Optimize for a specific platform
Tone	string	No	professional, casual, excited, humorous

Account — List

List all connected social media accounts.

Platform Notes

Platform	Char Limit	Media	Key Setting
Twitter/X	280	4 images or 1 video	`selectedCommunities`
LinkedIn	3,000	9 images or 1 video	`selectedLocation` (company)
Facebook	420	10 images or 1 video	`selectedPage` (required)
Instagram	2,200	10 images or 1 video	`postType` (reel/story)
TikTok	2,200	35 images or 1 video	`privacy_status`, `interactions`
Bluesky	300	4 images or 1 video	—
Pinterest	500	1 image or 1 video	`selectedBoard` (required)
Threads	500	10 images or 1 video	`reply_control`
YouTube	5,000	1 video	—

Troubleshooting

Error	Cause	Fix
`UNAUTHORIZED`	Invalid or missing API key	Check your credential in n8n. Keys start with `sr_live_`.
`FORBIDDEN`	Missing scope	Your API key needs the right scope (read/write/ai). Create a new key with the needed scopes.
`LIMIT_EXCEEDED`	Monthly post limit reached	Upgrade your plan or wait for the next billing cycle.
`RATE_LIMITED` (429)	Too many requests	Wait and retry. Limits: Creator 60/hr, Business 300/hr, Agency 1000/hr.
`BAD_REQUEST`	Invalid input	Check the error message for details. Common: missing content, invalid platform, date in the past.