A connector is an account the user has linked to a profile. 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.
Social & Publishing
Meta
Facebook & Instagram posts, ads, comments and DMs (Messenger + Instagram Direct, message requests included). A Page-less Instagram account uses the Instagram connector. Posts can never be edited.
FacebookInstagramAd campaignsLead formsInsightsCommentsDMs
- 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 profile: teammates can use it, and only the person who authorised it can disconnect it.
Instagram
An Instagram account on its own, no Facebook Page needed. Everything Meta does for Instagram, minus ads. A Page-linked account, or one you advertise on, goes on Meta instead, never both.
PublishReelsCarouselInsightsCommentsDMs
- Key
instagram- 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 profile: teammates can use it, and only the person who authorised it can disconnect it.
WhatsApp
Message customers from the business’s own WhatsApp number, once they have opted in. Use this only for a number you don’t have yet; one you already manage is ticked on Meta instead, never both.
MessagingTemplatesInboxBroadcasts
- Key
whatsapp- 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 profile: teammates can use it, and only the person who authorised it can disconnect it.
Telegram
Post to a channel, group or chat as your own bot, and read replies. 4096 characters of text, 1024 with media. Telegram cannot list a bot’s chats, so you name the destination.
PostScheduleCarouselVideoMessagesDelete
- Key
telegram- Linked by
- Pasting a credential in the app.
- Scope
- Shared with the whole profile: teammates can use it, and only the person who authorised it can disconnect it.
Bluesky
Post as your account: 300 characters, plus EITHER up to 4 images OR one video, never both (video needs a confirmed email). DMs too: 1000 characters, text only.
PostScheduleImagesVideoDMsDelete
- Key
bluesky- Linked by
- Pasting a credential in the app.
- Scope
- Shared with the whole profile: teammates can use it, and only the person who authorised it can disconnect it.
Threads
Publish text, image or video posts, repost anyone, read how they performed, reply to and hide replies, search Threads. Threads has no edit, only delete and repost.
PublishRepostInsightsRepliesSearchDelete
- 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 profile: 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 profile: teammates can use it, and only the person who authorised it can disconnect it.
TikTok
Publish a video or photo post (up to 35 images), live or into drafts, and read how each did. TikTok’s API can’t delete or edit a post once it’s up; that’s done in their app.
PostingPost statsFollower stats
- 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 profile: teammates can use it, and only the person who authorised it can disconnect it.
LinkedIn
Post to a company Page or your profile, run ad campaigns, read your lead gen form leads (real-time to Hermoso or your CRM) and answer comments. Your profile is off unless you turn it on.
PublishingCompany PagesAd campaignsLead formsComments
- 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 profile: teammates can use it, and only the person who authorised it can disconnect it.
X (Twitter)
Post, thread, poll or reply, read performance and mentions, answer DMs. X keeps only 30 days of them. X charges per API call, so every action costs credits.
PublishThreadsAnalyticsDMsMentions
- 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 profile: teammates can use it, and only the person who authorised it can disconnect it.
Snapchat approval pending
Publish a finished video to your Public Profile as a Story or a Spotlight, and group Snaps into a Saved Story. Video only: 5–60s for a Story, 6–60s for a Spotlight, 540x960 minimum.
StoriesSpotlights
- Key
snapchat- 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 profile: teammates can use it, and only the person who authorised it can disconnect it.
Not offered yet. Snapchat posting is NOT BUILT — there are no Story, Spotlight or Saved Story tools or routes in Hermoso, only an OAuth descriptor. Snap has also not allowlisted this app for the Public Profile API (their own words: "The Public Profile API is currently allowlist only"), so BOTH the code and the access are outstanding. Snapchat ADS is a separate connector and is fully built and live.
Everything above is built and tested; what is missing is the platform's approval, not the code. Set SNAPCHAT_PROFILE_API_APPROVED=1 — but that is the SECOND of two steps and on its own it would offer a connector a user can authorize and then do nothing with. Step one is to build the publish path: Stories, Spotlights and Saved Stories have no tools and no routes today. Step two is Snap allowlisting the client id (a request to a Snap point of contact, who enables it against the OAuth app); no deploy is needed beyond the env var. snapchat_ads is unaffected either way.
Reddit approval pending
Post to a subreddit, read and answer the comments, edit a text post’s body or delete it. One subreddit at a time. Reddit bans cross-posting. Titles can never be edited.
PublishCommentsEditDelete
- 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 profile: 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
Publish image and video Pins to a board you pick, edit or delete Pins and boards afterwards, and read how each one did.
PublishBoardsEditDelete
- 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 profile: teammates can use it, and only the person who authorised it can disconnect it.
Google Business Profile
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 profile: teammates can use it, and only the person who authorised it can disconnect it.
Advertising
Meta
Facebook & Instagram posts, ads, comments and DMs (Messenger + Instagram Direct, message requests included). A Page-less Instagram account uses the Instagram connector. Posts can never be edited.
FacebookInstagramAd campaignsLead formsInsightsCommentsDMs
- 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 profile: 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 profile: teammates can use it, and only the person who authorised it can disconnect it.
Microsoft Ads
Campaigns, ad groups, search ads, keywords, budgets and reporting on Bing.
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 profile: teammates can use it, and only the person who authorised it can disconnect it.
Apple Ads
App Store search ads and Ads on Apple Maps, all created PAUSED. An App Store ad renders from your App Store Connect page, not an image you upload; a Maps ad uses your own image.
CampaignsKeywordsReportingCreatives & adsApple Maps brands
- Key
apple_ads- Linked by
- Pasting a credential in the app.
- Scope
- Shared with the whole profile: teammates can use it, and only the person who authorised it can disconnect it.
AppLovin Ads
Campaigns, creative sets, reporting and the website pixel for AppLovin Ads, for websites and apps. New campaigns start paused, so nothing spends until you turn them live.
ReportingPixelCampaignsCreative sets
- Key
applovin_ads- Linked by
- Pasting a credential in the app.
- Scope
- Shared with the whole profile: 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. Campaigns, budgets and reporting; one format only, a text + image card, no video.
ReportingCampaignsBudgets
- Key
openai_ads- Linked by
- Pasting a credential in the app.
- Scope
- Shared with the whole profile: teammates can use it, and only the person who authorised it can disconnect it.
LinkedIn
Post to a company Page or your profile, run ad campaigns, read your lead gen form leads (real-time to Hermoso or your CRM) and answer comments. Your profile is off unless you turn it on.
PublishingCompany PagesAd campaignsLead formsComments
- 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 profile: teammates can use it, and only the person who authorised it can disconnect it.
TikTok Ads
TikTok ad campaigns, budgets and reporting.
Ad campaignsReporting
- Key
tiktok_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 profile: teammates can use it, and only the person who authorised it can disconnect it.
Snapchat Ads
Snapchat campaigns, ad squads, budgets and performance. Headlines run up to 34 characters.
Ad campaignsReporting
- Key
snapchat_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 profile: teammates can use it, and only the person who authorised it can disconnect it.
Reddit Ads
Reddit ad campaigns, ad groups, budgets and reporting.
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 profile: teammates can use it, and only the person who authorised it can disconnect it.
X Ads
X (Twitter) campaigns, line items, promoted posts, targeting and reporting.
Ad campaignsReporting
- Key
x_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 profile: teammates can use it, and only the person who authorised it can disconnect it.
Pinterest Ads
Pinterest campaigns, ad groups, budgets and reporting, promoting Pins that are already live.
Ad campaignsReporting
- Key
pinterest_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 profile: teammates can use it, and only the person who authorised it can disconnect it.
Analytics
Google Analytics
GA4 traffic, conversions and realtime activity by channel, campaign or landing page, plus key events and custom dimensions. Only properties you tick are readable.
ReportsRealtimeProperties
- Key
google_analytics- 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 profile: teammates can use it, and only the person who authorised it can disconnect it.
Google Tag Manager
Your site’s analytics and conversion tags. Audit what is live and stage new ones. Nothing Hermoso writes reaches a visitor until you publish the container.
Tag auditConversion tagsTriggersPublish
- Key
google_tag_manager- 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 profile: teammates can use it, and only the person who authorised it can disconnect it.
Google Search Console
Impressions, clicks, CTR and position for the organic traffic Google sends you, the one place real search terms still exist. Plus per-page index status and sitemaps.
Search termsIndex statusSitemaps
- Key
google_search_console- 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 profile: teammates can use it, and only the person who authorised it can disconnect it.
Bing Webmaster Tools
Bing search terms, clicks and position, crawl issues and inbound links, plus keyword research with real impression volumes and no ad spend. Bing also feeds Copilot.
Search termsKeywordsCrawl
- Key
bing_webmaster- Linked by
- Pasting a credential in the app.
- Scope
- Shared with the whole profile: teammates can use it, and only the person who authorised it can disconnect it.
HubSpot
Your CRM: read and search contacts, create or update one by email, push Meta and LinkedIn lead-form leads in as contacts without twins, and report deals by stage, source and month.
ContactsLead syncDeals
- Key
hubspot- 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 profile: teammates can use it, and only the person who authorised it can disconnect it.
Vercel
Your websites on Vercel: projects, deployments and domains, page views and visitors by page, referrer and campaign, and a landing page published as a preview or to production when you say so.
SitesWeb AnalyticsDeploys
- Key
vercel- Linked by
- Pasting a credential in the app.
- Scope
- Shared with the whole profile: teammates can use it, and only the person who authorised it can disconnect it.
Stripe
Revenue, refunds, customers, subscriptions and MRR from your own Stripe account, plus products, prices, payment links, coupons and refunds created from here. Live-account writes confirm first.
RevenueCustomersSubscriptionsProducts
- Key
stripe- Linked by
- Pasting a credential in the app.
- Scope
- Shared with the whole profile: teammates can use it, and only the person who authorised it can disconnect it.
PostHog
Per-user funnels, retention and session replay: the questions GA4 cannot answer. Replays come back as links you open in PostHog.
HogQLInsightsSession replay
- Key
posthog- Linked by
- Pasting a credential in the app.
- Scope
- Shared with the whole profile: teammates can use it, and only the person who authorised it can disconnect it.
Mixpanel
Retention cohorts, event breakdowns and the events a project actually records, plus any saved Mixpanel report, read straight back by its id.
InsightsRetentionEvents
- Key
mixpanel- Linked by
- Pasting a credential in the app.
- Scope
- Shared with the whole profile: teammates can use it, and only the person who authorised it can disconnect it.
Amplitude
Event segmentation, funnels with a conversion window, retention curves, and one person’s full activity stream, found by user id, device id or just the start of one.
FunnelsRetentionUser activity
- Key
amplitude- Linked by
- Pasting a credential in the app.
- Scope
- Shared with the whole profile: teammates can use it, and only the person who authorised it can disconnect it.