OmniSocials API

Create, schedule, update, publish, and delete social media posts across every connected channel. This is the core of the OmniSocials API.

Upload and manage images, video, and PDFs (up to 100 MB per upload, 1 GB from a URL) for use in posts, reels, stories, and PDF carousels.

Organize uploaded media into folders: list, create, and delete them to keep large asset libraries manageable.

Save reusable, named groups of hashtags per workspace and apply one to a new post in a single call, appended to captions or dropped into the auto first comment.

List and inspect the social accounts connected to a workspace across all 13 supported platforms.

Fetch post-level and account-level metrics (impressions, engagement, reach, and follower stats) in single or bulk requests.

Approval workflows (configured in the dashboard). List them here, route a new post through one with approval_workflow_id on POST /posts/create, and decide with POST /posts/{id}/approve or /reject.

Manage webhook subscriptions for real-time events (post.scheduled, post.published, post.failed, post.approved, post.rejected). Deliveries are signed with HMAC-SHA256.

Search and attach location tags (such as Instagram place tags) to posts.

Search and attach Instagram audio tracks, including trending music, to reels.

List and check the product Pins of the connected Pinterest account, to tag products on a Pin with pinterest.product_tags.

Read and reply to Instagram and Facebook DMs, comments, and mentions, LinkedIn company-page comments and mentions (LinkedIn has no API DMs), TikTok video comments (comments only; replies capped at 150 characters), YouTube video comments, X DMs for opted-in workspaces, and Threads replies and mentions. GET /inbox/next is a work queue: it serves the next item that needs an answer together with its conversation and the post it is on, and a reply sent with include_next chains straight to the following one. Comments on Facebook, Instagram, TikTok, YouTube and Threads can be hidden (POST /inbox/messages/{id}/hide); Facebook, Instagram and TikTok comments can be deleted (DELETE /inbox/messages/{id}). Replies sent from the native apps are mirrored into the inbox and count as answers. Reads require the inbox:read scope; replies, marking read, hiding and deleting require inbox:write. Replies are limited to existing conversations (no cold outreach) and to the platform messaging window. Each workspace can send up to 1,000 replies per rolling 24 hours; contact [email protected] for a higher limit.

Comment-to-DM automations on the connected Instagram account or Facebook Page (platform): a keyword in a comment on a post (or in a DM, or in an Instagram story reply) gets a DM back, once per person, with an optional public reply under the comment. On Facebook the DM lands in Messenger. Create one for an OmniSocials post (post_id), for a post published outside OmniSocials (instagram_media_id or facebook_post_id), for the next post the workspace publishes, or for every post. Opt-in scopes automations:read and automations:write. A post can also carry its automations at create time (comment_dm_automation on POST /posts/create, with platforms for Instagram, Facebook or both).