A connector is an account the user has linked to a brand workspace. Tools that publish, read insights or manage campaigns act through one — so post_to_x works when X is connected and answers 401 when it is not.
Generated from the shipped connector table. The description and capability chips below are the same strings the product renders on its own Connectors page, and the approval notes are the same gate table the server enforces. Nothing here is a second copy that can drift.
Three rules that explain most connector behaviour
Linking needs a browser; using does not. OAuth means a consent screen, so an agent can never connect a new account — it uses what is already linked and sends the user to the app for the rest. list_connectors shows what a workspace has.
Accounts are picked, never guessed. One person often administers several Facebook Pages or LinkedIn company Pages. Only the accounts ticked for a brand are usable, enforced on the server, and an empty selection shares nothing. Read them with list_connector_accounts, change them with set_connector_accounts.
“Not connected” has exactly one shape.401 with a connector field naming the provider. A 401without that field means the caller's own session or key is bad. See Errors.
Social & Publishing
Meta
Post to Facebook & Instagram, and build and run ad campaigns.
FacebookInstagramAd campaignsInsightsComments
Key
meta
Linked by
OAuth — the user approves it in a browser. An agent cannot link a new account; it can only use one already linked.
Scope
Shared with the whole brand workspace — teammates can use it, and only the person who authorised it can disconnect it.
Threads
Publish text, image or video posts, read how they performed, reply to the conversation, and search Threads.
PublishInsightsRepliesSearch
Key
threads
Linked by
OAuth — the user approves it in a browser. An agent cannot link a new account; it can only use one already linked.
Scope
Shared with the whole brand workspace — teammates can use it, and only the person who authorised it can disconnect it.
YouTube
Publish videos to your channel — public, unlisted or private — then read performance and reply to comments.
PublishCommentsAnalytics
Key
youtube
Linked by
OAuth — the user approves it in a browser. An agent cannot link a new account; it can only use one already linked.
Scope
Shared with the whole brand workspace — teammates can use it, and only the person who authorised it can disconnect it.
TikTok
Publish a video or a photo post (up to 35 images) — live on your profile, or into drafts to review in the app first.
VideoPhoto postsDrafts
Key
tiktok
Linked by
OAuth — the user approves it in a browser. An agent cannot link a new account; it can only use one already linked.
Scope
Shared with the whole brand workspace — teammates can use it, and only the person who authorised it can disconnect it.
LinkedIn
Post to a company Page or your profile, and run LinkedIn ad campaigns. Which identities this brand may act as is yours to choose — your profile is off unless you turn it on.
PublishingCompany PagesAd campaigns
Key
linkedin
Linked by
OAuth — the user approves it in a browser. An agent cannot link a new account; it can only use one already linked.
Scope
Shared with the whole brand workspace — teammates can use it, and only the person who authorised it can disconnect it.
X (Twitter)
Post, thread, poll or reply, then read performance and mentions. X charges per API call, so every action costs a few credits.
PublishThreadsPollsAnalyticsMentions
Key
x
Linked by
OAuth — the user approves it in a browser. An agent cannot link a new account; it can only use one already linked.
Scope
Shared with the whole brand workspace — teammates can use it, and only the person who authorised it can disconnect it.
Reddit approval pending
Post text, links or images to a subreddit, and read the score and comments back. One at a time — Reddit bans accounts that repost across communities.
PublishStats
Key
reddit
Linked by
OAuth — the user approves it in a browser. An agent cannot link a new account; it can only use one already linked.
Scope
Shared with the whole brand workspace — teammates can use it, and only the person who authorised it can disconnect it.
Not offered yet. Reddit has not approved API access for this app yet (approval ticket, not a credential).
Everything above is built and tested; what is missing is the platform's approval, not the code. Set REDDIT_API_APPROVED=1 alongside REDDIT_CLIENT_ID/REDDIT_CLIENT_SECRET once the ticket is granted.
Pinterest
Pin image and video ads to a board you pick, and run Pinterest ad campaigns. New campaigns start paused.
PublishBoardsAd campaigns
Key
pinterest
Linked by
OAuth — the user approves it in a browser. An agent cannot link a new account; it can only use one already linked.
Scope
Shared with the whole brand workspace — teammates can use it, and only the person who authorised it can disconnect it.
Google Business Profile approval pending
Post updates, events and offers to your Google Search & Maps listing, and read the calls, clicks and directions they drive.
PublishOffersInsights
Key
google_business
Linked by
OAuth — the user approves it in a browser. An agent cannot link a new account; it can only use one already linked.
Scope
Shared with the whole brand workspace — teammates can use it, and only the person who authorised it can disconnect it.
Not offered yet. Google has not allowlisted the Business Profile API for this project yet (default quota is 0 QPM, so every call 403s).
Everything above is built and tested; what is missing is the platform's approval, not the code. Set GOOGLE_BUSINESS_API_APPROVED=1 once Google grants the project access — no deploy needed beyond the env var.
Advertising
Meta
Post to Facebook & Instagram, and build and run ad campaigns.
FacebookInstagramAd campaignsInsightsComments
Key
meta
Linked by
OAuth — the user approves it in a browser. An agent cannot link a new account; it can only use one already linked.
Scope
Shared with the whole brand workspace — teammates can use it, and only the person who authorised it can disconnect it.
Google Ads
Campaigns, budgets and reporting for Google Ads. New campaigns start paused, so nothing spends until you enable them.
ReportingCampaignsBudgets
Key
google_ads
Linked by
OAuth — the user approves it in a browser. An agent cannot link a new account; it can only use one already linked.
Scope
Shared with the whole brand workspace — teammates can use it, and only the person who authorised it can disconnect it.
Microsoft Ads
Campaigns, ad groups, search ads and keywords on Bing. Everything starts paused, so nothing spends until you activate it.
ReportingCampaignsBudgets
Key
microsoft_ads
Linked by
OAuth — the user approves it in a browser. An agent cannot link a new account; it can only use one already linked.
Scope
Shared with the whole brand workspace — teammates can use it, and only the person who authorised it can disconnect it.
ChatGPT Ads
Ads inside ChatGPT — the sponsored card under an answer. One format only: a text + image card, no video. Everything starts paused.
ReportingCampaignsBudgets
Key
openai_ads
Linked by
Pasting a credential in the app.
Scope
Shared with the whole brand workspace — teammates can use it, and only the person who authorised it can disconnect it.
LinkedIn
Post to a company Page or your profile, and run LinkedIn ad campaigns. Which identities this brand may act as is yours to choose — your profile is off unless you turn it on.
PublishingCompany PagesAd campaigns
Key
linkedin
Linked by
OAuth — the user approves it in a browser. An agent cannot link a new account; it can only use one already linked.
Scope
Shared with the whole brand workspace — teammates can use it, and only the person who authorised it can disconnect it.
Reddit Ads
Reddit ad campaigns, ad groups, budgets and reporting. Everything starts paused, so nothing spends until you say so.
Ad campaignsReporting
Key
reddit_ads
Linked by
OAuth — the user approves it in a browser. An agent cannot link a new account; it can only use one already linked.
Scope
Shared with the whole brand workspace — teammates can use it, and only the person who authorised it can disconnect it.
Pinterest
Pin image and video ads to a board you pick, and run Pinterest ad campaigns. New campaigns start paused.
PublishBoardsAd campaigns
Key
pinterest
Linked by
OAuth — the user approves it in a browser. An agent cannot link a new account; it can only use one already linked.
Scope
Shared with the whole brand workspace — teammates can use it, and only the person who authorised it can disconnect it.
Files & Documents
Google Drive
One connection for Drive, Sheets and Docs — pull files into the composer, save renders back, build reports and briefs. Hermoso only ever sees the files you pick in the Google picker.
DriveSheetsDocs
Key
google_drive
Linked by
OAuth — the user approves it in a browser. An agent cannot link a new account; it can only use one already linked.
Scope
Private to the person who connected it.
OneDrive
Save finished renders into OneDrive, and organize them into folders.
Key
microsoft_onedrive
Linked by
OAuth — the user approves it in a browser. An agent cannot link a new account; it can only use one already linked.
Scope
Private to the person who connected it.
Notifications & Automation
Slack
A message in your channel the moment a render finishes or fails.
Key
slack
Linked by
Pasting a credential in the app.
Scope
Private to the person who connected it.
Discord
A ping in your server every time a render finishes or fails.
Key
discord
Linked by
Pasting a credential in the app.
Scope
Private to the person who connected it.
Webhook
POST a JSON event to any URL — Zapier, Make, n8n — when a render finishes.
Key
webhook
Linked by
Pasting a credential in the app.
Scope
Private to the person who connected it.
Custom MCP
Tools from any MCP server you run become live tools for the Studio agent.