Dashboard section for Instagram, Threads, LinkedIn, and X (paid plans) — connect accounts, draft posts, approve with a schedule, and let Aveiro dispatch through Chirio. Agents can draft via API and MCP; humans approve.
Social publishing is a dashboard section for Instagram, Threads, LinkedIn, and X (paid plans). Connect accounts through Chirio, compose posts with per-platform captions and media, submit for review, approve with a schedule, and let Aveiro dispatch at the right time. Publishing always requires a human click — agents can draft via API and MCP, not approve.
What social publishing is
Social is Aveiro's editorial pipeline for short-form social posts. It lives in the organization dashboard — separate from the site editor — and covers:
Connected accounts — Instagram, Threads, LinkedIn, and X (paid plans) linked through Chirio
Post drafts — captions, per-platform overrides, media, and target accounts
Review and approval — a human approves or rejects before anything publishes
Scheduling — pick a publish time; a background dispatcher sends due posts
Feedback thread — comments and rejection reasons agents can read when revising drafts
Open Social in the dashboard sidebar when the feature is enabled for your organization.
Availability
Social publishing is generally available for every organization — it is on by default and Social appears in the dashboard sidebar.You need the Audience manage capability (owners and admins have this by default). Org owners can turn the feature off under Organization → Features if you do not need social posting.If Chirio is not configured on the deployment, the Accounts page shows a setup notice and the Add button stays disabled.
How it differs from site publishing
Surface
What you publish
Approval
Site editor
MDX pages and site settings to your domain
You choose when to publish from the editor menu
Social dashboard
Instagram, Threads, LinkedIn, and X posts via Chirio
A human must approve; agents cannot publish autonomously
Audience
Email campaigns to subscribers
You send when ready; deliverability gates apply
Site SEO and social sharing settings control how links to your pages look when shared. The Social section publishes native posts to connected social accounts — a different channel with its own captions and media.
The Social page at a glance
Connected accounts
The Accounts page under Social lists which Instagram, Threads, LinkedIn, and X accounts are linked. Use Add in its header and pick a platform to start Chirio's OAuth flow. X is visible on every plan but connect and publish require a paid plan — the Add menu shows Paid plans with an upgrade link on free. You need at least one active account before approving a post.
The queue is grouped into four tabs — Review, Draft, Scheduled, and Published — each with a count badge. Review holds needs-review and rejected posts; Scheduled covers approved, scheduled, and in-flight publishing; Published includes successes and failures so you can retry without hunting.
Each post is one compact row inside its tab:
Status tag — Draft, Needs review, Scheduled, Published, and so on
Platform icons — which accounts the post targets
Caption preview — the base caption text
Schedule — confirmed time or an agent-proposed time (shown as proposed)
Click a row to expand the editor, action buttons, and feedback thread.
Use New post to open a composition dialog — nothing is saved until you click Save draft.
Post editor
Inside an expanded row you can:
Write a base caption used on every platform without an override
Pick target accounts with checkboxes
Open Platform override to edit per-platform captions and first comments in one dialog — required when Instagram (2,200 chars), Threads (500), or LinkedIn (3,000) need different copy
Attach media from the org library, upload, AI-generate, or register a public URL — uploads and library picks get aspect-ratio tags at register time
Click Set schedule to open a calendar and time picker; clear the adjacent control to approve without a future time
Media, aspect ratios, and auto crop
Social posts need different crops per platform — Instagram favors portrait (4:5), Threads often works best at 1:1, and landscape assets suit link previews elsewhere.
In the dashboard: the AI generator in the media picker includes an aspect ratio selector. Pick square, portrait, or landscape presets before generating. Each generation consumes org AI credits.
Via API and MCP: pass up to fouraspectRatios on POST /api/v1/social/media/generate (or aveiro_social_generate_media) to produce platform-fit crops from one prompt. Each ratio is billed separately and generated independently — reviewers see every asset before approval.
At publish: attach several generic assets (no per-platform assignment) and Aveiro auto-picks the best-matching ratio per target platform. Explicit per-platform media assignments still override auto-pick.
Social publishing uses its own publishing credits pool — separate from email sends and AI generation. Each successful network write debits credits when Chirio posts to a platform:
one post to one platform = one write
that target's first comment = another write when it posts successfully
Failed targets and refused comments cost nothing. Retries never double-charge targets that already published.
In the dashboard:Dashboard → Social shows a Publishing credits meter (used / plan limit) with Top up when you are near or over the limit — the same pattern as email usage on Audience.
Platform
Credits per write
Notes
Instagram
5
Same rate as Threads and LinkedIn
Threads
5
LinkedIn
5
X
25
Posts without a link in the caption or comment
X (with URL)
325
When the caption or first comment contains a link
Monthly grants by plan:
Plan
Publishing credits / month
≈ Meta writes
Free
100
~20
Starter
250
~50
Creator
1,000
~200
Professional
4,000
~800
Enterprise
Unlimited
—
AI image generation in the social media picker still draws from AI credits, not publishing credits. Top-ups from Billing add to a shared wallet that covers overage across metered features.
When credits run out, scheduled posts fail at dispatch with a clear per-target error. Approve and Post now run a pre-flight check so you see the estimated cost before publishing.
X on paid plans
Publishing to X requires Starter or above. X charges per post — up to 13× more when the caption or first comment contains a link — so the free monthly grant cannot cover even one link post. Agents targeting X on a free plan receive 402 PLAN_LIMIT from the social API.
Aveiro owns the editorial pipeline; Chirio is the publish pipe. The guardrail is structural:
Approve, reject, and post now exist only in the dashboard UI
Editing an approved post revokes approval and sends it back for review
The background dispatcher publishes only scheduled posts that were approved
Agent drafts (tagged agent on the row) can propose schedules and captions — they cannot bypass review
Agents and automation
AI agents and scripts can draft social posts through the REST API (/api/v1/social/*) or MCP tools (aveiro_social_*) when a token includes the social:write scope. Agents can list connected accounts, create and revise drafts, generate media, and read rejection feedback — but never approve or publish.
