Frequently asked questions

General

Which platforms does post.buzz support?

Sixteen: Instagram, Facebook, X (Twitter), Threads, LinkedIn, YouTube, TikTok, Reddit, Pinterest, Discord, Slack, Telegram, Mastodon, Bluesky, Dribbble, and Google Business. Instagram has two connection paths (direct and via Facebook). Not every platform supports every feature — see the capability matrix for what's available where.

What's the difference between an "agent" and "automation"?

Automation is rule-based and deterministic: "when X happens, do Y," or "post this on a schedule." Agents are AI-driven: they reason about goals and context, propose or take actions within boundaries, and learn from performance. Automation never improvises; agents do, within limits you set. See AI Agents.

Is there a free plan?

No free tier at signup — onboarding ends on a paid plan or its 7-day free trial. A limited free allowance set applies only if a subscription lapses or is cancelled (see plans).

Do you store my social media passwords?

No. Connections are made through each platform's official OAuth flow (Bluesky uses an app password; Telegram a bot token). We store revocable, encrypted access and refresh tokens — never your provider password. You can disconnect any account at any time.

What time zone do schedules use?

Scheduled times are stored in UTC and rendered in your local timezone. Each account also has its own IANA timezone setting that governs agent capacity and how posting days are bucketed. See Scheduling.

Publishing

What happens if my post breaks a platform's rules?

It's rejected before it's sent, with a clear message naming the constraint that failed (aspect ratio, file size, duration, character limit, etc.). You won't end up with a half-published cross-post. See platform limits.

Can I post different captions to different channels in one go?

Yes — use per-channel overrides in the composer (or the accountOverrides field in the REST API). The post stays a single unit but each channel can render tailored text.

Can I delete a published post?

From the app: on platforms whose APIs allow it — Instagram (via the Facebook connection), Facebook, X, Threads, LinkedIn, YouTube, Mastodon, and Bluesky — post detail offers Delete from platform. Others (TikTok, Reddit, Pinterest, …) don't permit deletion through their APIs. See the capability matrix.

Why did my post show as "failed" on one channel?

The platform rejected it after we submitted (distinct from our pre-publish validation). Common causes: a token expired and couldn't be refreshed, the media was rejected downstream, or a rate limit tripped. The post row carries the platform's error message; you can edit and retry. See Posts.

Why is my TikTok post stuck on "publishing"?

TikTok confirms publication asynchronously — post.buzz submits, TikTok processes, and a webhook finalizes the status. A few minutes' delay is normal; the post resolves to published or failed on its own.

Agents

How much control do I keep with an autonomous agent?

As much as you want. You set the agent's mode, posts per day, weekly cap, caption tone and length, allowed post types, and a failure threshold that pauses the agent after repeated failures. Every decision is logged. Start in approval mode and raise autonomy as trust grows.

What does an agent base its decisions on?

Your brand profile, the account's personality, active goals, the account's recent insights, and its own decision log. The audit log records the reason and insight basis for each action.

What happens when my AI allowance runs out?

AI features (agent runs, chat, captions, analysis, ideation) pause with a message saying the limit and when it resets — the first day of next month, UTC. Publishing, scheduling, and automation keep working. Unused allowance doesn't roll over.

Will agents post while I'm asleep?

Only if you've granted an auto-publish mode. In approval mode nothing publishes without you; the proposal buffer (max 5) keeps the queue sane while you're away. Boundaries like posting gaps and daily caps always apply.

Teams & accounts

What's the difference between an organization and a team?

The organization owns billing and members; teams are workspaces inside it that group channels — typically one per brand or client. Everyone in the org sees the same teams.

What happens when I disconnect a social account?

Its tokens are revoked and the account is soft-deleted: history is preserved, the plan slot frees up, and its goals are cleaned up. Reconnecting the same account re-imports without duplicates. See Connect a channel.

Billing

How do credits work?

Video credits pay for AI video generation only. Paid plans include a monthly allowance, and one-time credit packs top it up without expiring. AI actions (chat, captions, vision, analysis) and image generations are metered separately as monthly plan allowances. Credits are separate from your posting allowance.

Can I change plans?

Yes, any time — upgrades are prorated and apply immediately; downgrades apply at the next renewal. Changes are made in the payment provider's portal reachable from billing settings.

What happens to my data if I cancel?

Your content, accounts, and analytics are preserved; subscription-gated actions pause until you resubscribe. Deleting your account (different) is permanent and runs 24 hours after you confirm it.

API

Is there a public API?

Yes. post.buzz exposes a versioned REST API at /api/v1/... covering posts, accounts, media, comments, inbox, teams, analytics, CSV imports, and more — with an OpenAPI spec at /api/openapi.json. Authenticated with API keys. See REST API.

How do I get an API key?

Generate one in Settings → API Keys. Treat it like a password — it's shown once. See Authentication.

Is the API rate-limited?

There's no per-key request limit on /api/v1. Fair-use quotas apply per plan (posts, AI actions, and so on), anonymous public tools are capped at 5 per day per IP, and manual insight refreshes are capped per account per 24 h. See Limits.

More help

Can't find what you need? Reach out via the in-app support channel or open an issue on GitHub.