Help

Publish social posts with Blotato

Updated 3 min read
View as Markdown
On this page

Who this is for: Workspace admins and content operators who want an OPVS AI employee to publish or schedule social posts across connected channels without logging into each platform manually.

What this does: Connects your Blotato API key in OPVS, equips an agent with @opvs-ai/blotato, and lets the agent look up your Pages or boards, publish or schedule posts across ten platforms, and check whether each post went live.

Before you begin

  • You are a workspace admin on app.opvs.ai.

  • You have a Blotato account with your social channels already connected inside Blotato, and your Blotato API key ready.

  • Your workspace has at least one AI employee, or you are ready to install skills from the marketplace.

Steps

  1. Open Settings → Integrations in app.opvs.ai, choose Blotato, and paste your Blotato API key. Save the integration so OPVS routes @opvs-ai/blotato calls through your brand's own key.

  1. Open Skills in the sidebar and search for Blotato (@opvs-ai/blotato), or follow Find and download a skill from the skills store. Click Install, review the package details, and complete the install flow for your workspace.

  1. Assign @opvs-ai/blotato to the AI employee that handles your social publishing, or call it from your agent session.

  1. Ask your agent to list your connected accounts first (listAccounts) so it picks the right accountId for each platform (twitter, instagram, linkedin, facebook, tiktok, pinterest, threads, bluesky, youtube, or slack). If you are posting to a Facebook Page, LinkedIn company Page, YouTube playlist, Slack channel, or Pinterest board, have it look up the destination ID first (listSubaccounts or listPinterestBoards).

  1. Give the agent your finished post text, any media URLs, and whether to publish immediately, schedule at an ISO 8601 timestamp (scheduledTime), or queue into the next open Blotato slot (useNextFreeSlot: true).

Verify it worked

Ask the agent to check the submission status (getPostStatus) using the postSubmissionId returned when the post was created:

  • published — the post is live, and the response includes publicUrl when supplied by the platform.

  • scheduled — the post is queued in Blotato for the requested scheduledTime.

  • in-progress — Blotato is still processing the destination; wait at least 10 seconds and check again.

  • failed — read errorMessage to see which platform field or account permission needs fixing.

Troubleshoot

Why did my LinkedIn post go to a personal profile instead of our company Page? When target.pageId is omitted on LinkedIn, Blotato posts to the personal profile. Ask the agent to run listSubaccounts for your LinkedIn accountId and pass the company Page id as target.pageId.

Why did Blotato reject my TikTok, YouTube, or Pinterest post? Each platform requires specific target fields: TikTok requires privacy and disclosure flags, YouTube requires title and privacyStatus, and Pinterest requires boardId (from listPinterestBoards). Ask the agent to include the platform's required fields before submitting.

Why does listAccounts return no accounts or fail with an auth error? Check Settings → Integrations in app.opvs.ai to confirm your Blotato API key is saved, and confirm in Blotato that at least one social account is connected.

Did this answer your question?