GoSocial

Welcome to GoSocial

Captions by Claude, scheduled posts on YouTube, Facebook and Instagram.

Only the account(s) set as admin on the server can sign in.

Sign-in is not set up on this server yet. Configure Google or Microsoft sign-in (SOCIALPILOT_ADMIN_EMAIL plus the client settings).

Using GoSocial with a subscription? Sign in at the CivitasOPS portal and press Open GoSocial.

GoSocial is not open for your firm right now

Manage the subscription in the portal

Your videos, drafts and reports are kept. Nothing is posted while the subscription is not active.

Waiting for your approval

No drafts right now. Upload a video; a draft appears a minute or two later.

Review

Pick a draft on the left. Edit the text here; the preview on the right updates as you type.

Live previewHow the post will look on each platform, with the exact text that will be sent

The preview appears here once a draft is open.

Upload

A video for YouTube, Facebook and Instagram. Claude writes the title, captions, tags and hashtags; you review the draft before anything is scheduled.

Video (mp4, mov, m4v, webm) Notes for Claude: the topic, key points, who it is for (2–5 lines gives much better captions) Thumbnail (optional, jpg/png; used on YouTube and Facebook)

A picture for the Facebook Page and the Instagram feed (no YouTube). Claude writes the captions and hashtags; you review the draft before anything is scheduled. Instagram wants a JPEG between 4:5 and 1.91:1; a PNG is converted for you.

Picture (jpg, png) Notes for Claude: what is in the picture, the message, who it is for (2–5 lines gives much better captions)

Failed uploads

All videos

YouTube

Live from YouTube: the channel connected under Settings, with its latest uploads (private and unlisted included).

Facebook

Live from Facebook: the Page connected under Settings, with its latest posts: videos, Reels and photos.

Instagram

Live from Instagram: the account connected under Settings, with its latest posts and Reels.

Comments on your latest posts. Reply here and it is posted under your channel, Page or account, just like in the app.

Growth plan from Claude

Claude reads your recent uploads on all three platforms (dates, views, likes) and proposes posting times in your audience's time zone, a week of posts and video ideas. A new plan costs a few cents of Claude usage.

Path to monetization

Watch hours and Shorts views are estimates from public uploads; YouTube only counts "qualified" ones. The official numbers live in YouTube Studio → Earn, the Facebook Professional dashboard → Monetization, and the Instagram Professional dashboard. Thresholds checked on 18 October 2026.

Alerts

Run log

Weekly reports

A report is made every Monday from the posts GoSocial published. stats_latest.csv is the full data for Excel / Power BI.

Settings (config.yaml)

Posting times, platforms, voice, notifications, test mode. Changes apply on the next run.

YouTube

Google OAuth client file (type "Web application")

Add this redirect URI to the OAuth client in Google Cloud:

Facebook Page & Instagram

Set META_PAGE_ID, META_PAGE_ACCESS_TOKEN (a long-lived Page token) and INSTAGRAM_USER_ID on the server (README Step 3), restart it, then check again.

Sign in to Facebook and tick the Page you post from. The Instagram business or creator account linked to that Page comes with it. We never see your password, and you can disconnect at any time.

Enter the details by hand instead

Your Page and the Instagram business or creator account linked to it. The token is a long-lived Page access token from your own Meta app; it is stored encrypted and never shown again.

Facebook Page ID Page access token Instagram account ID (optional)

Only an administrator of your firm can change this connection.

Google sign-in

Google OAuth client file (type "Web application")

Add this redirect URI to the OAuth client in Google Cloud:

Notifications

Set a webhook or email under notifications in the settings, then send a test.

About

API documentation: /docs. Calls need Authorization: Bearer <token>; use the token from this sign-in or the server's SOCIALPILOT_API_TOKEN.