Make Modules Reference | SocialRails Documentation

All available modules for the SocialRails Make integration.

Instant Triggers

Watch Post Published

Fires immediately when a post is successfully published. Uses webhooks for real-time delivery.

Output Fields:

Field	Type	Description
event	string	Always `post.published`
post_id	string	Published post UUID
platform	string	Platform it was published to
post_url	string	URL of the live post
published_at	string	ISO 8601 timestamp

Watch Post Failed

Fires immediately when a post fails to publish.

Output Fields:

Field	Type	Description
event	string	Always `post.failed`
post_id	string	Failed post UUID
platform	string	Platform it failed on
error_message	string	Reason for failure
failed_at	string	ISO 8601 timestamp

Watch Post Scheduled

Fires immediately when a new post is scheduled.

Output Fields:

Field	Type	Description
event	string	Always `post.scheduled`
post_id	string	Scheduled post UUID
platform	string	Target platform
scheduled_for	string	ISO 8601 scheduled date
created_at	string	ISO 8601 creation timestamp

Actions

Create a Post

Schedule or draft a new social media post.

Input Fields:

Field	Type	Required	Description
Content	text	Yes	Post text (max 5,000 chars)
Platform	select	Yes	twitter, linkedin, facebook, instagram, tiktok, bluesky, pinterest, threads, youtube
Schedule For	date	No	When to publish (ISO 8601). Leave empty for draft.
Media Keys	text	No	Comma-separated R2 keys from the Upload Media module
Platform Settings	text	No	JSON string of platform-specific overrides

Output Fields:

Field	Type	Description
id	string	Created post UUID
platform	string	Target platform
status	string	`scheduled` or `draft`
scheduled_for	string	Scheduled date (if set)
created_at	string	Creation timestamp

Batch Create Posts

Create the same post across multiple platforms at once.

Input Fields:

Field	Type	Required	Description
Content	text	Yes	Default post content (max 5,000 chars)
Platforms	text	Yes	Comma-separated list (e.g. "twitter,linkedin,facebook")
Schedule For	date	No	When to publish (ISO 8601)
Platform Content	text	No	JSON with per-platform content overrides
Media Keys	text	No	Comma-separated R2 keys

Output Fields:

Field	Type	Description
batch_id	string	Batch UUID
posts	array	Array of created posts (id, platform, status)

Update a Post

Update a draft or scheduled post. Only draft and scheduled posts can be updated.

Input Fields:

Field	Type	Required	Description
Post ID	text	Yes	UUID of the post to update
Content	text	No	New post content
Platform	select	No	New target platform
Schedule For	date	No	New schedule date (empty = convert to draft)
Media Keys	text	No	New comma-separated R2 keys
Platform Settings	text	No	JSON platform-specific overrides

Delete a Post

Delete a draft or scheduled post. Published and failed posts cannot be deleted.

Input Fields:

Field	Type	Required	Description
Post ID	text	Yes	UUID of the post to delete

Output Fields:

Field	Type	Description
id	string	Deleted post UUID
deleted	boolean	Always `true`

Generate AI Content

Generate social media copy using AI. Costs 2 AI credits per request.

Input Fields:

Field	Type	Required	Description
Prompt	text	Yes	What to generate (max 2,000 chars)
Platform	select	No	Optimize for a specific platform
Tone	select	No	professional, casual, friendly, formal, humorous, inspirational, educational, persuasive

Output Fields:

Field	Type	Description
content	string	Generated text
platform	string	Target platform (if specified)
tone	string	Tone used

Upload Media

Upload an image or video from a URL. Use the returned key in Create a Post or Batch Create Posts.

Input Fields:

Field	Type	Required	Description
URL	url	Yes	Public URL of the image or video (max 10MB)

Output Fields:

Field	Type	Description
media_id	string	Media UUID
key	string	R2 key to use in post creation
url	string	Hosted URL of the uploaded file

Get Analytics

Pull engagement metrics for your workspace.

Input Fields:

Field	Type	Required	Description
Period	select	No	7d (default), 30d, 90d, 365d
Platform	select	No	Filter by platform
Post ID	text	No	Get analytics for a specific post

Output Fields:

Field	Type	Description
period	string	Time period
total_posts	number	Total posts in period
by_platform	array	Per-platform breakdown (posts, engagement, impressions, reach, followers)
overview	object	Totals and growth percentages

Get Account Settings

Get platform capabilities, character limits, and workspace defaults for a specific connected account.

Input Fields:

Field	Type	Required	Description
Account ID	text	Yes	UUID of the account

Output Fields:

Field	Type	Description
account_id	string	Account UUID
platform	string	Platform name
capabilities	object	Character limits, media specs, threading support
defaults	object	Workspace default settings
available_tools	array	Available platform tools

Get Workspace Info

Retrieve workspace details, plan limits, and current usage.

Output Fields:

Field	Type	Description
id	string	Workspace UUID
name	string	Workspace name
plan	string	Current plan name
limits	object	API requests/hr, max keys, max posts/month, AI credits
usage	object	Current month usage

Searches

Get a Post

Find a specific post by its ID.

Input Fields:

Field	Type	Required	Description
Post ID	text	Yes	UUID of the post

Output Fields:

Field	Type	Description
id	string	Post UUID
content	string	Post text content
platform	string	Target platform
status	string	draft, scheduled, posted, failed
scheduled_for	string	Scheduled date
posted_at	string	Published date
created_at	string	Creation date

List Posts

List posts with optional filters.

Input Fields:

Field	Type	Required	Description
Status	select	No	Filter: draft, scheduled, posted, failed
Platform	select	No	Filter by platform
Sort By	select	No	created_at (default) or scheduled_for
From	date	No	Posts created after this date
To	date	No	Posts created before this date
Limit	number	No	Results per page (1-100, default 50)
Offset	number	No	Pagination offset

List Accounts

Get all connected social media accounts in your workspace.

Output Fields:

Field	Type	Description
id	string	Account UUID
provider	string	Platform name
name	string	Account display name
status	string	`connected` or `expired`
connected_at	string	Connection timestamp

Multi-Step Scenario Example

A complete scenario that generates AI content, uploads an image, and schedules a batch post:

Module 1 — Scheduler: Run every Monday at 9:00 AM

Module 2 — SocialRails: Generate AI Content

Prompt: "Write a motivational post for the start of the work week. Keep it under 280 characters."
Tone: inspirational

Module 3 — SocialRails: Upload Media

URL: Map from a previous module or use a static URL

Module 4 — SocialRails: Batch Create Posts

Content: Map content from Module 2
Platforms: twitter,linkedin,threads
Schedule For: Map from the scheduler
Media Keys: Map key from Module 3

Troubleshooting

Error	Cause	Fix
`UNAUTHORIZED`	Invalid or missing API key	Recreate your connection with a valid API key
`FORBIDDEN`	Missing scope	Create a new API key with the needed scopes (read/write/ai)
`LIMIT_EXCEEDED`	Monthly post or AI credit limit reached	Upgrade your plan or wait for the next billing cycle
`RATE_LIMITED` (429)	Too many requests	Add a delay between modules. Limits: Creator 60/hr, Business 300/hr, Agency 1,000/hr
`BAD_REQUEST`	Invalid input	Check the error details. Common: missing content, invalid platform, date in the past