Skip to main content

Core concepts

A handful of concepts underpin everything in post.buzz. Once these click, the rest of the product follows naturally.

Organization → team → account​

post.buzz has a three-level hierarchy:

  • Your organization is the billing and identity container. New accounts get a personal org automatically; you can rename it or run several (plan permitting).
  • Teams (workspaces) inside the org group social accounts — typically one per brand or client. Everything you do happens inside a team (/t/<teamId>/…), and the sidebar's team switcher moves between them. Teams can be created, renamed, and deleted; a team with accounts must be emptied first, and the last team can't be deleted.
  • Accounts are the connected social channels, each belonging to exactly one team and carrying its credentials, profile info, and per-account settings (timezone, posting gap, personality).

See Organizations and Teams.

Posts​

A post is a single piece of content you intend to publish. The important idea: a post is one logical unit, even when it goes to many channels.

  • A post has a caption, optional first comment, a post type (post, reel, story, short, poll, thread, … depending on platform), attached media, and a status.
  • When you publish to multiple channels at once, the post is fanned out into per-channel post accounts, each of which can carry its own caption or field overrides. They're grouped atomically by a crossPostGroupId.
  • A post's status moves through: draft → scheduled → publishing → published (or failed) — per channel, independently.

This cross-post model is what lets one compose session produce tailored output on every platform. See Compose and Posts.

Media​

Media are the images, videos, and documents in your media library. They're stored once, described by AI (so captions can see them), organized into collections, and validated against platform limits before entering a post. Collections double as the approved source pool for agents.

Global upload ceilings: 25 MB for images, 100 MB for video and documents — with plan and per-platform limits often lower. We enforce the smallest of the two.

Agents​

An agent is a bounded AI worker assigned to one or more accounts. Rather than a generic "generate" button, an agent has a mode that defines how much autonomy it has, plus configurable boundaries like posting frequency, caption tone, and which post types it may produce.

Every action an agent takes is recorded in a decision audit log — what it decided, why, and what insight it based that on — so you can review and steer it. Work an agent produces for your review lands in the ideation feed. See AI Agents.

Automation​

Automation covers the rule-based systems that act without an agent in the loop:

  • Scheduling & recurrence — post at a time, or repeat on a schedule.
  • Comment automation — keyword-triggered replies or DMs.
  • RSS feeds — auto-post new items from an external feed.
  • Plugs & webhooks — trigger→action rules in-app, and event delivery to your own systems.

See Automation.

Metering: AI actions, image generations, credits​

Three separate meters, so one workload never starves another:

  • AI actions — every AI inference path (captions, chat, analysis, agent runs, ideation, media vision). A monthly allowance per plan.
  • Image generations — AI image creation, with its own (larger) monthly allowance.
  • Video credits — the balance for AI video generation. Paid plans include a monthly allocation; one-time credit packs top it up and never expire.

Monthly allowances reset on the first day of each month (UTC). Your plan determines all of them, plus channels, storage, seats, and agents. There is no free tier at signup — onboarding ends on a plan or its 7-day trial; the free allowances below apply when a subscription lapses.

Free†StarterCreatorProBusinessAgency
Channels35102040100
Posts / month30Unlimited*Unlimited*Unlimited*Unlimited*Unlimited*
X posts / month301002507502,0005,000
AI actions / month1005001,5005,00015,00050,000
Image generations / month525752005001,500

† The free tier is not marketed and not available at signup — it's the state of a lapsed or cancelled subscription. * Unlimited publishing is subject to fair use and social-platform API limits.

Next​

With the model in hand, the Features guides go deep on each surface — and the Developers section covers the REST API built on top of these same concepts.