Skip to main content
Docs navigation

Connectors

Connect the social, CMS, and CRM accounts your Powers act on.

Most Powers act on an external account — an Instagram profile, a WordPress site, a HubSpot CRM. A connector is the OAuth link between your IP Bot user and that account. A Power lists its requiredConnectors; if one is missing or its scopes are insufficient, the run fails with FORBIDDEN / a typed error.

Connect an account

Connect accounts from the app (Settings → Connections / OAuth). Each connector runs the provider's OAuth flow and stores the grant against your user.

Supported connectors

ConnectorProviderUsed for
InstagrammetaComment/DM replies, Stories, posts. Needs pages_show_list + pages_manage_posts to publish.
FacebookmetaPage posts & publishing. Shares the Meta OAuth connection with Instagram.
LinkedInlinkedinMember-profile posts (w_member_social) — compose text/image/multi-image/video/document/article/poll posts from the web composer or CLI. IP Bot publishes at the scheduled time (LinkedIn has no native scheduling). Company Page publishing + analytics pending Community Management API approval. 60-day tokens; reconnect when prompted.
WordPresswordpressPublish blog posts to a connected site.
YouTubegoogleSource videos for YouTube → blog / research Powers.
HubSpothubspotCRM lookups for the email-paying-clients Power.
GmailgoogleSend emails / calendar entries from Ops Powers.

Check publish-readiness

accounts list shows every connected account with publish-readiness flags (canPost, missingScopes, requiresReauth) and resolves @handle → IG/Page IDs — so you can confirm a publish will succeed before running a Power:

bash
> npx @island-pitch/ip-bot-cli accounts list --user $SUB --output json

If canPost is false, reconnect the account (additive re-auth) to grant the missing scopes listed in missingScopes. Over MCP, the same data comes from the list_accounts tool.