VanX Social Planner Skill

Post content to all connected social channels via the GHL Social Planner API — no manual copy-paste into VanX required.

Credentials

Scope requirements: The key must have socialplanner/post.write and socialplanner/account.readonly. If you get a 401, regenerate the key in VanX → Settings → Integrations → Private Integrations with those scopes added.

Quick Start — Use the Script

For any posting task, use the pre-built script directly:

python /home/ubuntu/skills/vanx-social-planner/scripts/post_to_vanx.py \
  --caption "Your caption text #hashtag" \
  --image-url "https://cdn.example.com/image.jpg" \
  --minutes-ahead 15 \
  --type post

Always run with --dry-run first to preview which channels will be targeted before posting live:

python /home/ubuntu/skills/vanx-social-planner/scripts/post_to_vanx.py \
  --caption "Test" --dry-run

The script automatically:

• Fetches all connected accounts for the location
• Filters to real social platforms only (skips community/group channels)
• Skips expired OAuth tokens
• Posts to each active channel with the correct platform-specific payload

Workflow for Weekly Content Posting

1. Generate image using generate tool → save to /home/ubuntu/webdev-static-assets/
2. Upload to CDN using manus-upload-file /path/to/image.png → get public URL
3. Write caption — include brand voice, hook, CTA, and hashtags
4. Dry-run to confirm target channels
5. Post using the script with --minutes-ahead 15 (or longer for scheduled content)
6. Verify in VanX → Marketing → Social Planner → Calendar view

Posting to Specific Channels Only

To post to a subset of channels (e.g., Funnel Junkies only, not Van Studios), import the script as a module:

import sys
sys.path.insert(0, '/home/ubuntu/skills/vanx-social-planner/scripts')
from post_to_vanx import get_active_accounts, post_to_channel
from datetime import datetime, timezone, timedelta

accounts = get_active_accounts()
fj_accounts = [a for a in accounts if 'funnel' in a.get('name', '').lower()]

schedule_date = (datetime.now(timezone.utc) + timedelta(minutes=15)).strftime('%Y-%m-%dT%H:%M:%SZ')
for account in fj_accounts:
    result = post_to_channel(account, caption="Your text", image_url="https://...", schedule_date=schedule_date)
    print(result['channel'], '✅' if result['success'] else '❌')

Platform-Specific Rules

Story Posts

For Instagram/Facebook stories, omit the caption (script handles automatically with --type story):

python post_to_vanx.py --image-url "https://..." --type story --minutes-ahead 5

Troubleshooting

Verification After Posting

1. Go to VanX → Marketing → Social Planner
2. Switch to Calendar or List view
3. Confirm posts appear with correct scheduled time
4. After publish time: check each platform directly for the live post

Reference Files

• references/api-reference.md — Full endpoint docs, payload schemas, Eugene's account IDs, and error reference
• scripts/post_to_vanx.py — Production-ready posting script with CLI and importable module interface