Zapier Actions Reference | SocialRails Documentation

All available triggers, actions, and searches for the SocialRails Zapier integration.

Triggers

New Post (Polling)

Fires when a new post is created in your workspace. Zapier polls every 1-15 minutes depending on your plan.

Output Fields:

Field	Type	Description
id	string	Post UUID
content	string	Post text content
platform	string	Target platform
status	string	Post status (draft, scheduled, posted, failed)
scheduled_for	string	ISO 8601 scheduled date
posted_at	string	ISO 8601 published date (if posted)
created_at	string	ISO 8601 creation date

Post Published (Instant)

Fires immediately when a post is successfully published via webhook.

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

Post Failed (Instant)

Fires immediately when a post fails to publish via webhook.

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

Actions

Create Post

Schedule or draft a new social media post.

Input Fields:

Field	Type	Required	Description
Content	string	Yes	Post text (max 5,000 chars)
Platform	dropdown	Yes	twitter, linkedin, facebook, instagram, tiktok, bluesky, pinterest, threads, youtube
Schedule For	datetime	No	When to publish. Leave empty for draft.
Media Keys	string	No	Comma-separated R2 keys from media upload
Platform Settings	string	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	string	Yes	Default post content (max 5,000 chars)
Platforms	string	Yes	Comma-separated list (e.g. "twitter,linkedin,facebook")
Schedule For	datetime	No	When to publish
Platform Content	string	No	JSON with per-platform overrides, e.g. `{"twitter": "Short version"}`
Media Keys	string	No	Comma-separated R2 keys

Output Fields:

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

Generate AI Content

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

Input Fields:

Field	Type	Required	Description
Prompt	string	Yes	What to generate (max 2,000 chars)
Platform	dropdown	No	Optimize for a specific platform
Tone	dropdown	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 Post.

Input Fields:

Field	Type	Required	Description
URL	string	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

Searches

Find Post

Look up a specific post by its ID.

Input Fields:

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

Output Fields:

Same as New Post trigger output.

List Accounts

Get all connected social media accounts in your workspace.

Output Fields:

Field	Type	Description
id	string	Account UUID
provider	string	Platform name (twitter, linkedin, etc.)
name	string	Account display name
status	string	`connected` or `expired`
connected_at	string	Connection timestamp

Multi-Step Zap Example

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

Step 1 — Trigger: Schedule by Zapier (every Monday at 9 AM)

Step 2 — Action: SocialRails — Generate AI Content

Prompt: "Write a motivational LinkedIn post for the start of the work week"
Platform: linkedin
Tone: inspirational

Step 3 — Action: SocialRails — Upload Media

URL: https://example.com/images/monday-motivation.jpg

Step 4 — Action: SocialRails — Create Post

Content: Use output from Step 2
Platform: linkedin
Schedule For: Next Monday at 8:00 AM
Media Keys: Use key from Step 3

Troubleshooting

Error	Cause	Fix
`UNAUTHORIZED`	Invalid or missing API key	Reconnect your SocialRails account in Zapier with a valid 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	Reduce Zap frequency. Limits: Creator 60/hr, Business 300/hr, Agency 1,000/hr
`BAD_REQUEST`	Invalid input	Check the error message. Common: missing content, invalid platform, date in the past