Building a Fully Automated Facebook Post Scheduler using Node.js and GitHub Actions

How I Built a Zero-Cost Facebook Auto-Poster Using Node.js and GitHub Actions

Automating social media management can save hours of manual work. In this guide, I will show you how to build a fully automated, production-ready system that posts daily motivational quotes with images to a Facebook Page—completely for free, running on autopilot via GitHub Actions.

We will also tackle a major pain point: resolving Meta's strict token expiration and permission structures by dynamically fetching a Page Access Token using a Meta Business System User, the officially recommended way for secure automation.

---

🛠️ Prerequisites

Before diving into the code, make sure you have:

• A Facebook Page
• A Meta Developer Account
• A Meta Business Suite (Business Portfolio)
• A GitHub Account
• Basic knowledge of Node.js

---

🎯 Step 1: Configuring Meta Architecture for Secure Automation

Meta has deprecated direct publish_actions for user tokens, making automated image uploads tricky. The professional way to solve this is by using a System User bound to a Business Portfolio.

1. Create a Meta App

• Go to the Meta for Developers dashboard.
• Create a new app, choose Business and pages as the category, and give it a clean name.

2. Link your Facebook Page

• Inside your App Dashboard, navigate to App Settings -> Advanced.
• Scroll down to the App Page section and select your target Facebook Page to link it.

3. Setup a System User

• Go to your Meta Business Settings (business.facebook.com/settings).
• Under Users, click on System Users and create an Admin System User (e.g., Ttp-penguin).
• Click Assign Assets, select your Facebook Page, and turn on the Full Control (Everything) toggle.

4. Generate the Permanent Token

• Click Generate Token for that System User and select your app.
• Explicitly check these 3 essential scopes:
  • pages_manage_posts
  • pages_read_engagement
  • pages_show_list
• Copy the generated token (EAak2B...). Save this safely—this token acts as our master key!

---

💻 Step 2: Writing the Automation Script

We will write a Node.js script that does two things dynamically:

1. Hits the Meta Graph API /me/accounts endpoint using our Master System User Token to dynamically fetch the exact Page Access Token for our Page ID.
2. Uses FormData to securely stream a random local image with a quote to Facebook's /photos endpoint.

Initialize a new Node.js project (npm init -y), install the dependencies (npm install axios form-data), and create index.js:

const fs = require('fs');
const path = require('path');
const axios = require('axios');
const FormData = require('form-data');

// Configuration
const PAGE_ID = "YOUR_FACEBOOK_PAGE_ID"; 
const SYSTEM_USER_TOKEN = process.env.FB_ACCESS_TOKEN;

if (!SYSTEM_USER_TOKEN) {
    console.error("❌ Error: Missing FB_ACCESS_TOKEN in environment variables.");
    process.exit(1);
}

// 🔑 Step A: Dynamically resolve the Page Access Token
async function getPageAccessToken() {
    try {
        console.log("🔑 Fetching Page Access Token from Meta...");
        const url = `[https://graph.facebook.com/v21.0/me/accounts?access_token=$](https://graph.facebook.com/v21.0/me/accounts?access_token=$){SYSTEM_USER_TOKEN}`;
        const response = await axios.get(url);

        const pages = response.data.data;
        const targetPage = pages.find(p => p.id === PAGE_ID);

        if (!targetPage) {
            throw new Error(`Could not find a Page Access Token for Page ID: ${PAGE_ID}`);
        }

        console.log(`✅ Successfully extracted Page Access Token for: ${targetPage.name}`);
        return targetPage.access_token;
    } catch (error) {
        console.error("❌ Failed to get Page Access Token:", error.response ? error.response.data : error.message);
        throw error;
    }
}

// 📸 Step B: Choose local content and stream onto Facebook
async function publishDailyPost() {
    try {
        const PAGE_ACCESS_TOKEN = await getPageAccessToken();

        // 1. Pick a random text caption from quotes.json
        const quotesPath = path.join(__dirname, 'quotes.json');
        const quotesData = JSON.parse(fs.readFileSync(quotesPath, 'utf8'));
        const randomQuote = quotesData[Math.floor(Math.random() * quotesData.length)];
        const caption = `${randomQuote.text}\n\n${randomQuote.hashtags}`;

        // 2. Pick a random image from the /images folder
        const imagesFolder = path.join(__dirname, 'images');
        const files = fs.readdirSync(imagesFolder);
        const imageFiles = files.filter(file => /\.(jpg|jpeg|png)$/i.test(file));

        if (imageFiles.length === 0) {
            throw new Error("No images found in the 'images' folder.");
        }

        const randomImage = imageFiles[Math.floor(Math.random() * imageFiles.length)];
        const imagePath = path.join(imagesFolder, randomImage);

        console.log(`📸 Selected Image: ${randomImage}`);
        console.log(`📝 Selected Caption: ${randomQuote.text}`);

        // 3. Build Multipart Form Data and hit Meta Graph API
        const url = `[https://graph.facebook.com/v21.0/$](https://graph.facebook.com/v21.0/$){PAGE_ID}/photos?access_token=${PAGE_ACCESS_TOKEN}`;

        const formData = new FormData();
        formData.append('source', fs.createReadStream(imagePath));
        formData.append('caption', caption);

        console.log("🚀 Publishing Photo to Facebook Page...");
        const response = await axios.post(url, formData, {
            headers: formData.getHeaders()
        });

        console.log(`✅ Image successfully published! Photo ID: ${response.data.id}`);

    } catch (error) {
        console.error("❌ --- DETAILED FACEBOOK ERROR ---");
        if (error.response) {
            console.error(JSON.stringify(error.response.data, null, 2));
        } else {
            console.error(error.message);
        }
        process.exit(1);
    }
}

publishDailyPost();

📂 Step 3: Preparing Content & Managing Environment

For the script to choose randomly, organize your project files like this:

• quotes.json: An array containing your motivational quotes and hashtags.
• images/: A folder filled with your custom templates or pictures (1.png, 2.jpg, etc.).

🔒 Setting up GitHub Repository Secrets

To keep your credentials secure, never hardcode your tokens.

1. Push your code to your GitHub repository.
2. Go to Settings -> Secrets and variables -> Actions.
3. Click New repository secret:
   • Name: FB_ACCESS_TOKEN
   • Value: Paste the long master token you got from the Meta System User.

⚠️ Crucial DevOps Tip: Ensure your local .env files are added to .gitignore. If a local environment file accidentally gets tracked and pushed to GitHub, it will override your encrypted repository secrets during runtime and throw authentication faults!

---

🚀 Step 4: Orchestrating Automation with GitHub Actions

Now, let's create a serverless routine that runs our script completely on autopilot. Create a workflow configuration file at .github/workflows/post.yml:

name: Daily Facebook Auto Post

on:
  schedule:
    - cron: '30 16 * * *' # Executes automatically every single day at 10:00 PM IST
  workflow_dispatch: # Allows us to manually trigger the script from the UI anytime

jobs:
  post:
    runs-on: ubuntu-latest
    steps:
    - name: Checkout repository
      uses: actions/checkout@v4

    - name: Set up Node.js
      uses: actions/setup-node@v4
      with:
        node-version: 24 # Uses the latest stabilized execution runtime

    - name: Install dependencies
      run: npm install

    - name: Run Auto Post Script
      env:
        FB_ACCESS_TOKEN: ${{ secrets.FB_ACCESS_TOKEN }}
      run: node index.js

🔥 Verification and Conclusion

Once everything is committed, navigate to the Actions tab in your GitHub repository, select your workflow, and hit Run workflow.

If your tokens are properly mapped, the execution block will pass flawlessly with a green status badge (✅). Check your Facebook Page immediately, and you will see your freshly streamed image post standing live!

You now have a production-ready, maintenance-free cloud architecture that posts content to your brand page on total autopilot without spending a single dime!

---

Happy coding! If you found this helpful, drop a comment or share your automation use-cases below! 🚀