Revival Crop Nutrition
Social Connection Setup

How to connect your social accounts

Step-by-step instructions for getting the credentials each platform needs. Once you have these saved on the Social Connections page, every Approved post is auto-published — no copy-pasting between systems.

One-click vs paste-token. LinkedIn and Facebook/Instagram have proper "Sign in with…" buttons — you just log in normally and we handle the rest. X (Twitter), TikTok and YouTube still need a manually-copied token from their developer dashboards. That's a platform limitation, not ours — these guides walk you through it.
Print or save this guide as a PDF — keep it handy for new clients.
LinkedIn Facebook + Instagram X (Twitter) TikTok YouTube
in

LinkedIn

Company Page posting · One-click sign-in available
✅ Easy path — Sign in with LinkedIn

On the Social Connections page, click the blue Sign in with LinkedIn button. You'll be sent to LinkedIn's normal login page. Sign in with the account that admins the company page, then click Allow. You'll be returned here with the company page already linked. Done.

Only if Sign-in is blocked or you want manual control:

What you'll need Access to linkedin.com/developers/apps (any LinkedIn account works) and admin role on the LinkedIn Company Page you want to post to.
  1. Go to linkedin.com/developers/apps. Sign in with the LinkedIn account that admins the company page.
  2. Click Create app. Name it anything (e.g. "Revival Social Publisher"). Pick the company page as the verified company. Tick the legal agreement. Click Create app.
  3. In the new app, go to the Products tab. Request access to Share on LinkedIn, Sign In with LinkedIn using OpenID Connect, and Marketing Developer Platform (Community Management API). The first two are automatic; Marketing Developer Platform requires LinkedIn's review — usually approved within a day.
  4. Once approved, go to the Auth tab. Note the Client ID and Client Secret at the top.
  5. Under OAuth 2.0 settings, add this redirect URL:
    https://sphere-portal-api.claire-boshoff.workers.dev/social-auth/callback/linkedin
  6. Save and come back to the Social Connections page. Click Sign in with LinkedIn — the OAuth flow will now succeed.
Token lifetime LinkedIn access tokens last 60 days. The system stores the expiry date and will prompt for re-connect a few days before. If you ever see "Needs Reconnect" on the dashboard, click Reconnect and sign in again.
f

Facebook + Instagram

One sign-in covers both — Page + linked IG Business account
✅ Easy path — Sign in with Facebook

On the Social Connections page, click the blue Sign in with Facebook button. You'll be sent to facebook.com's permission screen. Tick every Page and Instagram account the system should post to. Click Continue. You're done — both Facebook Pages and any linked Instagram Business accounts are connected in one shot.

Before clicking — make sure of this Sign in with the personal Facebook account that admins the Facebook Page. If the Page is owned by a Business Manager, that personal account must have the Manage Page permission. For Instagram: the IG account must be a Business or Creator account (not Personal), and it must be linked to the Facebook Page in IG Settings → Account → Linked accounts.

If "Sign in with Facebook" doesn't list your Page:

  1. Open business.facebook.com in the same browser and sign in. Confirm the Page is listed under your admin Pages.
  2. Go to Settings → People → Add Person and grant yourself Manage Page if you don't already have it.
  3. Go to Linked Accounts in Instagram (mobile app: Profile → ☰ → Settings → Accounts Centre) and confirm IG → FB Page link.
  4. Come back and click Sign in with Facebook again — the missing Pages should now appear.
Token lifetime Facebook Page Access Tokens (which is what this system uses) never expire as long as the admin doesn't change their password or revoke the app. The Status badge stays green indefinitely.
𝕏

X (Twitter)

Manual token paste · No one-click sign-in yet
What you'll need An X account in Basic ($100/mo) or higher tier — the Free tier doesn't allow programmatic posting. If the client doesn't have a paid X dev account, post to X manually for now.
  1. Sign in at developer.x.com/portal/dashboard.
  2. Create a new Project + App. Name them whatever (e.g. "Revival Publisher").
  3. In the App settings → User authentication settings, set App permissions to Read and write. Set Type of App to "Web App, Automated App or Bot". For Callback URI, paste:
    https://sphere-portal-api.claire-boshoff.workers.dev/social-auth/callback/x
  4. Go to Keys and tokens. Under Access Token and Secret, click Generate. Copy both immediately — they only show once.
  5. Back on the Social Connections page, click Paste token on the X card. Paste the access token. Save.
Heads up — paid tier required X removed the free posting API in 2023. You need at least the Basic tier ($100/month) to publish via the API. If the client doesn't post often enough to justify that, leave the X card empty and post manually.
TT

TikTok

Manual token paste · TikTok Content Posting API
What you'll need The TikTok Business account (not personal). Access to developers.tiktok.com with the business account signed in.
  1. Go to developers.tiktok.com/apps. Sign in with the business account.
  2. Click Create App. Fill in basic details. TikTok will email you to verify.
  3. In the new app, request access to the Content Posting API. This requires submitting a use case (paste: "Internal publishing for our company's TikTok account from our marketing dashboard"). Approval is usually 1-3 days.
  4. Once approved, go to Add Redirect URI and paste:
    https://sphere-portal-api.claire-boshoff.workers.dev/social-auth/callback/tiktok
  5. Copy the Client Key and Client Secret from the app overview. Run the access-token request curl shown in the TikTok docs (or send the link to us — we can run it).
  6. Paste the resulting access token on the Social Connections page, TikTok card.
YT

YouTube

Manual token paste · YouTube Data API v3 OAuth
What you'll need A Google account that admins the YouTube channel. Access to console.cloud.google.com.
  1. Open console.cloud.google.com. Create a new project (e.g. "Revival YouTube Publisher").
  2. In the new project, go to APIs & Services → Library. Enable the YouTube Data API v3.
  3. Go to Credentials → Create Credentials → OAuth client ID. App type = Web application. Add this authorised redirect URI:
    https://sphere-portal-api.claire-boshoff.workers.dev/social-auth/callback/youtube
  4. Copy the Client ID and Client Secret. Go to developers.google.com/oauthplayground. Click the gear icon → tick Use your own OAuth credentials → paste them.
  5. In the Playground, in step 1 select YouTube Data API v3 → https://www.googleapis.com/auth/youtube.upload. Click Authorize APIs. Sign in with the YouTube channel's Google account, approve.
  6. In step 2, click Exchange authorization code for tokens. Copy the Access Token that appears.
  7. Paste it on the Social Connections page, YouTube card.
Tokens expire Google access tokens last 1 hour. For production we'd wire up the refresh-token flow — for now, this token works for a 1-hour test. Send us the refresh token from step 2 and we'll add automatic refresh on the worker side.
Tip — when onboarding a new client, hand them this guide. They'll have everything connected in 30 minutes.