Connecting to Facebook

1. Create a New App

• Visit: https://developers.facebook.com
• Click on “My Apps” (top-right). (If you don’t have a developer account, create one by clicking Get Started.)
• Click “Create App”.
• Fill in:
  • App Name (anything you like)
  • Contact Email
  • Select the use case: Choose “Other“
  • Select the app type: Choose “Business”.
• Click “Next”.
• Click “Create App” and complete any security checks (CAPTCHA).

Make sure you have enabled the necessary permissions:

• Which permission? pages_show_list (required to list pages).
• Where to add it? As a scope in Facebook Login (OAuth).
• What does the client do? When logging into the app with Facebook, they must approve this permission.
• In production? If the app is “Live,” you need to request approval for pages_show_list under App Review → Permissions & Features.
• Technical note: The /me/accounts call must be made with a user access token (not an app or page token).

Permissions list:

'pages_manage_posts',
'pages_show_list',
'pages_read_user_content',
'pages_read_engagement',
'Read_insights'

2. Add Facebook Login App

Once your app is created, you will see a page titled “Add products to your app”:

• Find Facebook Login in the product list and click Set Up.
• Open the Facebook Login Settings page from the left sidebar.
• Enable the Login with the JavaScript SDK option.
• Add your frontend application URL to the Allowed Domains for the JavaScript SDK section.
• Click Save Changes to apply the configuration.

3. Adjusting App Settings

• Go to the “Settings” > “Basic” section in the left sidebar.
• Fill in the highlighted parts as shown in the platform:
  • Privacy Policy URL – Enter the URLs of the relevant policy pages of your site.
  • Copy your App ID and App secret. Enter your App ID and App Secret to the appropriate field in the social configuration section.

That’s all! Now you can start posting.

Connecting to Instagram

• Create a Meta App if you haven't already by following the Facebook setup steps above.
• Connect your Instagram Professional Account to your Facebook Business Page.
• Ensure your Instagram account is set as a Business or Creator account.
• Configure your Meta App credentials (App ID, App Secret, and API Version) in the platform settings.
• Once connected successfully, you can publish posts, reels, stories, and other Instagram media directly from the platform.

Connecting to YouTube

1. Create a Google Cloud Project

• Visit the Google Cloud Console.
• Log in with your Google Developer account, click the project dropdown at the top, and click "New Project".
• Give your project a name and click "Create".

2. Enable YouTube Data API v3

• In the top search bar of the Cloud Console, search for "YouTube Data API v3".
• Click on the API from the search results, then click the "Enable" button.

3. Configure OAuth Consent Screen

• Navigate to APIs & Services > OAuth consent screen from the left sidebar navigation menu.
• Select User Type: Choose "External" to allow credentials to be used by public accounts, and click "Create".
• Fill in the required application registration details:
  • App Name: Name of your app (e.g., ReelEaseAI)
  • User support email: Choose your email
  • Developer contact information: Input your email address
• Click "Save and Continue".
• Under "Scopes", click "Add or Remove Scopes", add the following scopes, and save:
  • https://www.googleapis.com/auth/youtube.upload
  • https://www.googleapis.com/auth/youtube.readonly
  • https://www.googleapis.com/auth/youtube.force-ssl
• Under "Test Users", add any Google account email addresses you wish to use for testing before publishing the app.
• Click "Save and Continue" to finish.

4. Create OAuth 2.0 Credentials

• Navigate to APIs & Services > Credentials.
• Click "+ Create Credentials" at the top and select "OAuth client ID".
• Select Application type: Choose "Web application".
• Name the client (e.g., ReelEaseAI Web Client).
• Add the following redirect URI to the "Authorized redirect URIs" section:

  http://localhost:5000/api/social/youtube/callback

  Note: In production environments, replace http://localhost:5000 with your actual live server backend domain name.

• Click "Create" to view your Client ID and Client Secret credentials.

Connecting to Threads

1. Create a Meta Developer App

• Go to the Meta for Developers Portal.
• Go to "My Apps" and click "Create App".
• Under use case selection, choose "Other" and click "Next".
• Select app type: Choose "Business" or "None".
• Enter your app details and click "Create App".

2. Add the Threads Product

• In the product dashboard setup list, locate Threads and click "Set Up".
• From the left sidebar, click Threads > Settings.

3. Configure OAuth Settings

• Add the following redirect URI to the "Threads OAuth Redirect URIs" field:

  http://localhost:5000/api/social/threads/callback

  Note: In production environments, replace http://localhost:5000 with your actual live server backend domain name.

• Click "Save Changes".

4. Configure Permissions & API Scopes

• Ensure your app requests the required Threads API scopes:
  • threads_basic: Required to retrieve profile info and details.
  • threads_content_publish: Required to publish status posts, media attachments, and videos.
• In production, request approval for these permissions under App Review > Permissions and Features.

5. Retrieve App ID & App Secret

• Go to Settings > Basic in the sidebar navigation.
• Locate and copy the App ID and App Secret.

Connecting to TikTok

1. Register a Developer Account

• Visit the TikTok Developer Portal.
• Register a developer account or log in with your existing TikTok account.
• Click "Manage Apps" and click "Connect an App" to create a new application.

2. Configure Application Details & OAuth

• Fill in the app registration form (App Name, Category, Description, and Icon).
• Navigate to the **Redirect URI** section and add the TikTok OAuth callback URL:

  http://localhost:5000/api/social/tiktok/callback

  Note: In production environments, replace http://localhost:5000 with your actual live server backend domain name.

• Enable the necessary permissions and API scopes:
  • user.info.basic: Required to read profile details.
  • video.publish or share.sound.video: Required to publish video content directly.
• Submit your application for review to transition it from sandbox/staging to live mode.

3. Retrieve Credentials

• Under your application dashboard, find and copy the Client Key (Client ID) and Client Secret.

Connecting to Twitter (X)

1. Access Twitter Developer Portal

• Go to the Twitter Developer Portal and log in with your developer account.
• Click **"Create Project"** and specify your project details (Name, Use Case, and Description).
• Create a new developer App under your project.

2. Configure User Authentication Settings

• In your App's settings tab, locate the **"User authentication settings"** section and click **"Set up"**.
• Enable OAuth 1.0a and OAuth 2.0.
• Choose your App Permissions: Select **"Read and Write"** (minimum required to publish posts) or **"Read and Write and Direct Messages"**.
• Specify your Type of App: Choose **"Web App, Automated App or Bot"**.
• Add the callback redirect URI:

  http://localhost:5000/api/social/twitter/callback

  Note: In production environments, replace http://localhost:5000 with your actual live server backend domain name.

• Fill in your website URL and click **"Save"**.

3. Retrieve Credentials

• Go to the **"Keys and tokens"** tab.
• Generate and copy the **Consumer Keys** (API Key & API Key Secret).
• Generate and copy the **Authentication Tokens** (Access Token & Access Token Secret).
• Generate and copy the **OAuth 2.0 Client ID and Client Secret**.

Connecting to LinkedIn

1. Create a LinkedIn Developer Application

• Go to the LinkedIn Developer Portal and log in.
• Click **"Create App"**.
• Enter your App Name, associate it with a verified LinkedIn Page, upload an App Logo, and agree to the terms.
• Click **"Create app"**.

2. Enable Products & API Permissions

• Navigate to the **"Products"** tab in your App's dashboard.
• Locate and request access to:
  • **"Share on LinkedIn"** (to publish posts on behalf of users)
  • **"Sign In with LinkedIn"** or **"Sign In with LinkedIn using OpenID Connect"** (to authenticate and link accounts)
• Wait for these products to be enabled (typically instant).

3. Configure OAuth & Redirect URI

• Go to the **"Auth"** tab.
• Under **"OAuth 2.0 settings"**, add the authorized Redirect URI:

  http://localhost:5000/api/social/linkedin/callback

  Note: In production environments, replace http://localhost:5000 with your actual live server backend domain name.

4. Retrieve Application Credentials

• Under the same **"Auth"** tab, copy the **Client ID** and **Client Secret**.