Connect accounts and publish clips

Connect accounts and publish clips

Connect the seven supported networks, publish finished clips, and set custom covers per platform.

Wallu publishes video and image posts to seven networks: X (Twitter), TikTok, Instagram, Pinterest, YouTube, Facebook, and LinkedIn. You connect each account once with OAuth, then publish finished clips straight from the video clipper or Studio, or queue them on a calendar (see the scheduler article on this page). New to the product? Start with getting started.

Connecting an account

Open Studio → Social Accounts. Each network shows a Connect button that starts its OAuth flow; after you approve, you return to the same panel with the account listed. Disconnecting removes the stored token.

<!-- SCREENSHOT: Social Accounts panel showing the seven platform tiles with Connect buttons -->

Who supplies the app keys

• X (Twitter) and Pinterest are bring-your-own-keys. You must paste your own developer app credentials (Client/App ID + Secret) before Connect works — otherwise the auth call returns "App not configured. Please enter your Client ID and Secret first."
• TikTok works with Wallu's shared app if an operator has configured it, or you can supply your own keys.
• YouTube, Facebook, Instagram, and LinkedIn use Wallu's managed app. If the platform's server credentials aren't set, Connect returns a 503 ("integration not configured").

Facebook Pages. Facebook connects a Page, not a personal profile. If Wallu can't auto-discover your Pages (common with Business-owned Pages), the flow asks you to enter your Page ID manually; the pending token is held for 15 minutes while you do.

Instagram requires an Instagram Business/Creator account linked to a Facebook Page — it rides on the same Facebook app credentials.

Token expiry and reconnecting

The account list carries each token's expiry, and the panel shows a warning banner as a token nears its end. If a publish fails because a token is dead or revoked, Wallu emails the account owner a reconnect prompt (deduped to once per 24 hours). Instagram, Facebook, and WhatsApp are skipped here because they have their own token-health checks.

Publishing a finished clip

The primary publishing path is the Publish button on a finished clip — in the clipper, My Studio, the clip detail view, or the Pro Editor. It posts the clip live immediately.

Direct clip publishing supports YouTube, TikTok, Instagram, Facebook, LinkedIn, and Pinterest. X (Twitter) is not a clip-upload target — Wallu posts text and threads to X, not uploaded video.

For Instagram, Facebook, LinkedIn, and Pinterest, Wallu hands the network a temporary public URL to your clip (a one-hour signed link) so the platform can fetch the file. YouTube and TikTok receive the raw video bytes.

First-comment CTA. You can attach a "first comment" that Wallu posts right after the clip goes live. This is wired for YouTube, Instagram, and Facebook only; TikTok, LinkedIn, and Pinterest have no comment step. It's best-effort — a missing permission never fails the post.

TikTok drafts. If your TikTok app isn't audited for direct posting, the upload lands in your TikTok app's drafts instead of going live. Wallu reports success with a note to "finish posting in the TikTok app," and records it as a draft (not a live post) so it doesn't inflate your analytics.

Custom covers and thumbnails

What you can set for the cover differs sharply per platform, because each network's API is different:

• YouTube — a full custom thumbnail image. YouTube only accepts custom thumbnails from phone/feature-verified channels; if yours isn't verified the thumbnail is silently skipped and the video still uploads. Max ~2 MB, JPEG or PNG.
• Instagram — a cover image, supplied as an absolute public URL. A relative path silently does nothing.
• Facebook — a cover image sent as a video thumbnail (up to ~4 MB). Best-effort: if the thumbnailed post is rejected, Wallu retries without it.
• Pinterest — a cover image for video pins, as an absolute public URL. If you don't set one, Pinterest auto-picks a frame.
• TikTok — no arbitrary cover image is possible. TikTok's API only takes a cover-frame timestamp: you scrub to a frame and that frame becomes the cover. It's ignored in the drafts fallback.
• LinkedIn — no custom cover.

To generate the cover image itself, see the thumbnail generator.

The scheduler, calendar, and AI campaigns

Queue posts on the calendar, understand the every-minute worker and its per-platform gaps, and run recurring AI campaigns.

Beyond publishing immediately, Wallu can queue posts for a future time and run recurring AI-written campaigns. Both are driven by one background worker that wakes every minute.

The calendar

Open Studio → Calendar. "Schedule post" opens a modal where you pick a connected account (which sets the platform), add a caption and/or attach media, and choose a date and time. Saving writes a pending entry, shown on the chosen day.

<!-- SCREENSHOT: Studio Calendar month view with a scheduled post on a day cell and the schedule modal open -->

• Post Now in the calendar isn't truly instant — it schedules the post a few seconds in the past so the every-minute worker picks it up on its next run (within about a minute).
• You can edit or reschedule a post only while it's pending or failed. Once it's posted you can't edit it, and you can't delete already-posted content.
• Clear calendar removes every entry from the calendar. It does not unpublish anything that already went live.

How the worker runs

The worker runs on a one-minute cron. Each tick it claims up to 10 due posts (scheduled time in the past, status pending), publishes them one at a time with a one-second gap, and marks each posted or failed. A failed post is retried with 5- then 10-minute backoff (3 attempts in all); on the third failure it's marked permanently failed with the error message attached.

Per-platform scheduling gap — read this. The timed worker publishes X (Twitter), YouTube, TikTok, Instagram, and Pinterest. It does not handle Facebook or LinkedIn — a scheduled Facebook or LinkedIn post fails with "Unsupported platform." To reach Facebook or LinkedIn, use the direct Publish button on a clip (covered in the other article on this page), which does support them.

Media requirements. YouTube and TikTok require a video file. Instagram and Pinterest require an image or video. A caption is optional when media is attached, but required when there's none. Scheduled X posts are text or threads only — Wallu doesn't attach media to tweets.

AI campaigns

A campaign auto-writes and publishes posts on a repeating schedule. Create one with a name and a content prompt, plus:

• Platform and account (default X/Twitter)
• Interval in hours (default 4) and max posts per day (default 6)
• Tone — professional, casual, humorous, witty, or educational
• Hashtags and an optional character limit (default 280)
• Image mode — none, a tagged library image, or a fixed custom image
• Use knowledge base (on by default)

Every minute the worker checks active campaigns; when one is due it generates a fresh post with AI, drawing on your prompt, your knowledge base, and recent posts (so it doesn't repeat itself), then publishes immediately and schedules the next one. When the daily cap is hit, the next post is pushed to 9 AM the following day. A campaign auto-pauses after five consecutive errors; you can also toggle it active/paused, preview a post, or delete it.

What campaigns can actually post. The generator writes a single text post (optionally with one image) — it does not produce video. So campaigns fit X/Twitter naturally, and Instagram or Pinterest only if you set an image mode (those networks reject text-only posts). Because they run through the same engine as the scheduler, video-only platforms (YouTube, TikTok) and the unsupported Facebook/LinkedIn won't work as campaign targets.

Related: post graphics

If you want a still graphic (not a clip) to attach, Wallu's Social Post Pro tool generates platform-styled post images in common aspect ratios (1:1, 4:5, 9:16, 1.91:1) and charges Studio Credits per image. It lives in Studio; see also the thumbnail generator.