Social Publishing (Admin)

Overview

Staff-only tool to upload a 30-day Excel calendar and schedule posts to Instagram, TikTok, Facebook, LinkedIn, YouTube, Pinterest, X (Twitter), Threads, Snapchat, and Reddit.

Path: /social-publishing/ (requires is_staff)

Workflow

  1. Open /social-publishing/ → Download Excel template
  2. Fill one row per post (publish_at, platform, caption, …)
  3. Upload plan and optionally mark posts as Scheduled
  4. Execute due posts via:
    - Run due queue now in the UI
    - Celery beat (every 60s when Celery is enabled)
    - Script: py -3.12 manage.py publish_social_posts

Publish modes (SOCIAL_PUBLISH_MODE)

Mode Behavior
dry_run (default) Marks posts published without calling social APIs — safe for local testing
webhook POSTs JSON payload to SOCIAL_PUBLISH_WEBHOOK_URL (Zapier / Make / n8n / Buffer)
api Calls configured platform APIs (Facebook page, LinkedIn, X when tokens are set); media-heavy platforms (IG, TikTok, YouTube, etc.) prefer webhook

Direct posting to every network requires Business accounts and app review. Most teams start with webhook → Buffer/Make, then add native API tokens selectively.

Help home Back to Nigall