Publish posts and handle comments, DMs, reviews and mentions across 13 social platforms through SocialAPI.ai.
Explore 92 workflow actions for SocialAPI, including account permissions and operation limits.
46 read actions46 write actions
WORKFLOW ACTIONS
What you can configure.
Choose an action in the workflow builder, connect an account, and map its inputs. These actions are available in the catalog; your account access and a successful test determine whether they work for your setup.
Add media to a Google Business Profile location
Write
Attaches one photo or video to a location's public profile under the given category.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a brand
Write
Creates a new brand for grouping connected social accounts.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a message template
Write
Submits a new message template to the WhatsApp Business Account (WABA) for review.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create or schedule a post
Write
Creates a post for one or more connected accounts.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create Pinterest board
Write
Creates a board on Pinterest and returns it.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete a brand
Write
Deletes a brand and disconnects all its connected accounts.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete a comment
Write
Deletes a comment on the platform and removes it from the inbox.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete a media file
Write
Delete a media file
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete a message template
Write
Deletes a template by name from the WhatsApp Business Account (WABA) associated with this connected account.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete or cancel a post
Write
Deletes a draft/scheduled/failed post locally, or deletes a published post from every platform that supports it.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete Pinterest board
Write
Deletes the board on Pinterest along with every pin saved to it.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Disconnect a social account
Write
Disconnects a connected account.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Edit a message template
Write
Updates the components of an existing message template by its WhatsApp template ID.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Edit a published YouTube video (title, description, visibility, Studio tags)
Write
Edit a published YouTube video (title, description, visibility, Studio tags)
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Edit a YouTube comment
Write
Edits the text of one of the connected account's own YouTube comments via comments.update.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Get a conversation
Read
Returns a single inbox conversation by ID.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
Get a message template
Read
Returns a single message template by its WhatsApp template ID.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
Get a single post
Read
Fetch a post with all platform delivery details.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
Get a WhatsApp Business Profile
Read
Returns the public business profile for a WhatsApp phone number, including about text, address, description, contact email, websites, and vertical.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
Get account analytics history
Read
Returns daily history for a connected account: follower levels, reach, and the other metrics the platform publishes.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
Get brand analytics history
Read
Returns daily history for every account and page in a brand, summed per metric per day.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
Get daily Facebook Page insights (beta)
Read
Beta.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
Get Facebook Page insights summary (beta)
Read
Beta.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
Get Google Business Profile performance metrics
Read
Returns daily time series for a location: how many people saw it on Google Search and Maps, and how many then called, asked for directions, messaged, booked, ordered, or clicked through to the.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
Get inbox sync status
Read
Reports whether a sync is running for the given target and when that target last completed one.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
Get Instagram account insights summary
Read
Returns live profile counts plus trailing-30-day insight totals (reach, views, interactions, engaged accounts, net follower change) for a connected Instagram account.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
Get LinkedIn insights (beta)
Read
Beta.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
Get one Google Business Profile media item
Read
Returns one photo or video from a location's profile.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
Get phone number registration status
Read
Returns whether a phone number is verified and registered with WhatsApp Business.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
Get Pinterest account summary
Read
Returns the connected Pinterest account's public profile counts: followers, pins, boards, and monthly views.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
Get platform constraints
Read
Returns media and text constraints for all supported platforms.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
Get platform usage limits
Read
Returns platform-specific quota data for a connected account as a key/value map where values are remaining counts.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
Get post analytics history
Read
Returns daily history for a published post: how its engagement counters accrued, one point per day.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
Get post metrics
Read
Fetches engagement metrics from platform APIs for a published post.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
Get resource usage for the current billing period
Read
Returns brands, posts, and interactions consumed during the current billing period alongside the plan limits.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
Get storage usage
Read
Returns total bytes used, the plan limit, and file count for the authenticated user.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
Get the search keywords that surfaced a Google Business Profile
Read
Returns the keywords people searched before seeing the location, aggregated by month over an inclusive YYYY-MM range.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
Get Threads insights (beta)
Read
Beta.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
Get TikTok account summary
Read
Get TikTok account summary
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
Get YouTube channel summary
Read
Get YouTube channel summary
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
Hide a comment
Write
Hides a comment on the platform so it is not visible to the public, and marks it hidden in the inbox.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Like a comment
Write
Likes a comment on the platform as the connected account.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
List a Google Business Profile location's media
Read
Lists the photos and videos on a location's public profile: its logo, cover, interior shots, and so on.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
List account pages
Read
Returns pages (e.g.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
List Accounts with reviews
Read
Lists your review-capable connected Accounts, each with its live review summary (average rating, total count, last review time).
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
List active Instagram stories
Read
Returns the currently-active stories for a connected Instagram account.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
List all posts
Read
Returns posts with rich filtering and cursor pagination.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
List brand mentions
Read
Fetches posts where your brand account was mentioned or tagged.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
List brands
Read
Returns all brands for the authenticated user with their connected account counts.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
List collaborators on an Instagram post
Read
Returns the collaborators invited on a co-authored Instagram post and the state of each invite (accepted, pending, declined).
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
List commented posts
Read
Returns inbox posts that have comments, ordered by most-recently-commented.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
List comments on a post
Read
Returns comments for a specific inbox post, including per-platform capability flags (canreply, candelete, canhide, canlike, canprivatereply).
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
List connected accounts
Read
Returns all active social media accounts connected to the authenticated API key's workspace.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
List inbox conversations
Read
Returns paginated DM conversations for the authenticated user, optionally filtered by account, platform, and status.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
List media files
Read
Returns a paginated list of uploaded media files for the authenticated user.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
List message templates
Read
Returns all message templates configured on the WhatsApp Business Account (WABA) associated with this connected account.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
List messages in a conversation
Read
Returns paginated messages for an inbox conversation, newest first.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
List Pinterest boards
Read
Returns the boards for a connected Pinterest account.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
List Pinterest pins
Read
Returns the connected Pinterest account's pins.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
List replies to a comment
Read
Returns paginated replies to a specific comment.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
List reviews for an Account
Read
Returns one page of reviews for a single connected Account, newest first by default.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
Mark conversation as read
Write
Resets the unread count on a conversation to zero.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Moderate a YouTube comment
Write
Sets the moderation status of a YouTube comment (published, heldforreview, or rejected), optionally banning the author.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Publish a draft post now
Write
Publishes a post in draft or scheduled status immediately.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Re-sync a connected account's posts
Write
Refreshes one connected account's posts: new posts appear, engagement counts update, and Instagram and Facebook media links in platformmedia are renewed.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Re-sync a TikTok account's videos
Write
Re-sync a TikTok account's videos
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Re-sync a YouTube account's videos
Write
Re-sync a YouTube account's videos
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
React to a message
Write
Adds or replaces the account's emoji reaction on a message.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Remove a reaction from a message
Write
Removes the account's emoji reaction from a message.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Remove media from a Google Business Profile location
Write
Deletes one photo or video you added to a location's profile.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Reply to a comment
Write
Posts a reply on the platform.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Reply to a mention
Write
Replies, as a public comment, to a mention of the connected account, including on a third-party post where the normal comment-reply endpoint is not permitted.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Reply to a review
Write
Posts a public reply to a review on the platform (e.g.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Retry a failed post
Write
Re-attempts publication of a post in failed or partial status.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Send a message in a conversation
Write
Sends an outgoing DM via the connected platform account and records it in the conversation.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Send a private reply to a commenter
Write
Sends a direct message to the author of a comment.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Send a template message
Write
Sends an approved WhatsApp template message to a recipient phone number.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Start an inbox sync
Write
Refreshes an account's inbox from the platform.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Unhide a comment
Write
Restores a previously hidden comment so it is publicly visible again.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Unlike a comment
Write
Removes a like from a comment on the platform.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Unpublish a post
Write
Unpublishes a published post from a specific account (if accountid provided) or all accounts.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update a brand
Write
Renames a brand.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update a Google Business Profile location
Write
Writes the location's public profile: name, description, phone numbers, address, website, categories, opening hours, service area.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update a post
Write
Updates the text, media, schedule time, targets, or hidden status of a pending post.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update a WhatsApp Business Profile
Write
Updates one or more fields of the public business profile (about, address, description, email, websites, vertical, profilepicturehandle).
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update account page
Write
Update a page's isdefault or isactive status.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update conversation status
Write
Sets the status of a conversation to active or archived.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update Pinterest board
Write
Update a board.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Validate a message template
Write
Dry-run validation of a WhatsApp message template against the Cloud API rules (name format, component cardinality, header format, text limits, placeholder sequencing, button constraints).
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
Validate post content
Read
Dry-run validation.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
Verify a media upload
Write
Confirms that a presigned-URL upload completed successfully and marks the media as ready.
Permissions and limits
Account permissions
A SocialAPI.ai API key (sapi_key_...) with social accounts connected in the dashboard
A repeated request may repeat the external action. Review the previous result before retrying a write.
SETUP
Start with a controlled test.
01Connect the intended account
Use the account and permissions required for your process. Review the connection check before configuring a workflow action.
02Review inputs and access
Select a listed operation and map its required inputs. Use test records and add a human approval before writes that need review.
03Confirm the result
Inspect step outputs and confirm the result in SocialAPI. A saved workflow is not a completed provider action.
Marketing ยท CONNECTION
