WhatsMine Documentation
Home
  • What is WhatsMine?
  • Feature Tour
  • Requirements
  • Installation
  • Configuration (.env reference)
  • Going Live Checklist
Admin Guide
User Guide
Integrations
  • Architecture
  • REST API v1
  • Production Deployment
  • Frequently Asked Questions
  • Troubleshooting
  • Changelog
Home
  • What is WhatsMine?
  • Feature Tour
  • Requirements
  • Installation
  • Configuration (.env reference)
  • Going Live Checklist
Admin Guide
User Guide
Integrations
  • Architecture
  • REST API v1
  • Production Deployment
  • Frequently Asked Questions
  • Troubleshooting
  • Changelog
  • Integrations

    • Integrations Overview
    • Meta / WhatsApp Business
    • Messenger & Instagram
    • SMS Providers
    • AI Providers
    • Payments (Stripe, PayPal & Paddle)
    • Social Networks
    • Google (Workspace & Places)
    • E-commerce (Shopify, WooCommerce, BigCommerce)
    • Email / SMTP
    • Real-time & Push Notifications
    • Storage

Social Networks

To use Social posting, you (the admin) register OAuth app credentials for each network. Then your customers connect their own accounts with one click.

Admin location: Admin → Integrations

Supported networks

NetworkCredentialsWhere to create the app
Facebook PagesUses your Meta App (App ID + Secret)Meta for Developers
InstagramUses your Meta AppMeta for Developers
LinkedInClient ID + Client SecretLinkedIn Developers
X / TwitterClient ID + Client SecretX Developer Portal
YouTubeClient ID + Client SecretGoogle Cloud Console
TikTokClient Key + Client SecretTikTok for Developers

Step 1 — Create each network's app

For each network you want to offer, create a developer app on that platform and obtain its OAuth credentials. Facebook and Instagram reuse your existing Meta App.

Step 2 — Register the OAuth redirect URL

In each network's app settings, add WhatsMine's callback URL as an authorised redirect URI:

https://your-domain.com/app/social/accounts/callback/{network}

…where {network} is facebook, instagram, linkedin, twitter, youtube or tiktok. For YouTube, also add the callback in your Google Cloud OAuth consent screen.

Step 3 — Enter credentials in WhatsMine

Location: Admin → Integrations → choose the network

Enter the Client ID / Secret (or Client Key / Secret for TikTok), then enable the integration.

📸 Screenshot: A social network OAuth integration form in admin.

Step 4 — Customers connect their accounts

Customers go to Social → Accounts, click Connect beside a network, authorise in the pop-up, and the account is ready to post to. See the Social user guide.

Permissions requested

Each network requests the scopes needed to publish on the user's behalf — for example, posting permissions for Facebook/Instagram Pages, w_member_social for LinkedIn, tweet read/write for X, upload scopes for YouTube, and publish scopes for TikTok. Most platforms require app review before these work for the public, so plan for that lead time.

Token refresh

WhatsMine automatically refreshes expiring OAuth tokens daily (via the scheduler) so your customers' connections keep working without re-authorising.

Troubleshooting

  • Connect fails / "redirect URI mismatch" — the callback URL in the network's app settings must exactly match https://your-domain.com/app/social/accounts/callback/{network}.
  • Posting fails — the network app may still be in development/review, or a required permission isn't approved.

➡️ Next: Google (Workspace & Places).

Last Updated: 6/19/26, 4:34 PM
Prev
Payments (Stripe, PayPal & Paddle)
Next
Google (Workspace & Places)