Skip to main content
Brands are the top-level container for everything in Autoposting. Every post, clip, carousel, and AI agent belongs to a brand — isolating connected accounts, timezone defaults, and team access per client, product, or persona.
Choose your brand slug carefully — slugs are unique per organization and cannot be changed after creation.

Properties

FieldTypeDescription
namestringDisplay name shown across the dashboard
slugstringURL-safe identifier, unique per org (e.g. acme-corp)
platformsstring[]Enabled platforms: x, linkedin, youtube, instagram, threads
timezonestringIANA timezone for scheduling defaults (e.g. America/New_York)
positionnumberSort order in the brand list
clipTemplateDefaultsobjectDefault caption preset, platform presets, and aspect ratios for clip renders

Create a Brand

curl -X POST https://app.autoposting.ai/api-proxy/brands \
  -H "Authorization: Bearer sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Corp",
    "slug": "acme-corp",
    "timezone": "America/New_York",
    "platforms": ["x", "linkedin"]
  }'

Connect Platforms

Each brand connects to one or more social accounts via OAuth. A single brand can hold multiple accounts on the same platform.
1

Open Connected Accounts

Navigate to the brand from the sidebar, then click Connected Accounts.
2

Select a platform

Click the platform tile — X, LinkedIn, Instagram, Threads, or YouTube.
3

Complete OAuth

Grant the requested scopes on the platform’s authorization page. Tokens are encrypted at rest and refreshed automatically before expiry.
Instagram requires a Business or Creator account linked to a Facebook Page. Personal Instagram accounts cannot be connected.
PlatformAuth ProtocolNotes
X (Twitter)OAuth 2.0 PKCE + OAuth 1.0aDual-flow for media uploads
LinkedInOAuth 2.0Separate credentials for personal vs. org pages
InstagramBusiness LoginRequires Facebook Page link
ThreadsGraph APISeparate from Instagram auth
YouTubeGoogle OAuth 2.0Requires channel with upload permissions

Team Permissions

Members can hold different roles per brand — Editor on Brand A, Viewer on Brand B.
RoleCreate PostsSchedulePublishConnect AccountsBrand Settings
OwnerYesYesYesYesYes
AdminYesYesYesYesYes
EditorYesYesYesNoNo
ContributorYesNoNoNoNo
ViewerNoNoNoNoNo
Use permission groups to define reusable access sets and assign members to a group instead of configuring per-brand access manually.

Posts

Publish to every connected platform on a schedule.

Platforms

OAuth flows, token lifecycle, and platform capabilities.

AI Agents

Agents inherit brand timezone and connected accounts.

API Reference

Full endpoint reference for brand management.