Brands

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

Field	Type	Description
`name`	string	Display name shown across the dashboard
`slug`	string	URL-safe identifier, unique per org (e.g. `acme-corp`)
`platforms`	string[]	Enabled platforms: `x`, `linkedin`, `youtube`, `instagram`, `threads`
`timezone`	string	IANA timezone for scheduling defaults (e.g. `America/New_York`)
`position`	number	Sort order in the brand list
`clipTemplateDefaults`	object	Default 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"]
  }'

const res = await fetch("https://app.autoposting.ai/api-proxy/brands", {
  method: "POST",
  headers: {
    Authorization: "Bearer sk_your_api_key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    name: "Acme Corp",
    slug: "acme-corp",
    timezone: "America/New_York",
    platforms: ["x", "linkedin"],
  }),
});
const { data } = await res.json();

Connect Platforms

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

Open Connected Accounts

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

Select a platform

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

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.

Platform	Auth Protocol	Notes
X (Twitter)	OAuth 2.0 PKCE + OAuth 1.0a	Dual-flow for media uploads
LinkedIn	OAuth 2.0	Separate credentials for personal vs. org pages
Instagram	Business Login	Requires Facebook Page link
Threads	Graph API	Separate from Instagram auth
YouTube	Google OAuth 2.0	Requires channel with upload permissions

Team Permissions

Members can hold different roles per brand — Editor on Brand A, Viewer on Brand B.

Role	Create Posts	Schedule	Publish	Connect Accounts	Brand Settings
Owner	Yes	Yes	Yes	Yes	Yes
Admin	Yes	Yes	Yes	Yes	Yes
Editor	Yes	Yes	Yes	No	No
Contributor	Yes	No	No	No	No
Viewer	No	No	No	No	No

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.

Getting Started

Core Concepts

Properties

Create a Brand

Connect Platforms

Team Permissions

Posts

Platforms

AI Agents

API Reference

​Properties

​Create a Brand

​Connect Platforms

​Team Permissions

Posts

Platforms

AI Agents

API Reference

Properties

Create a Brand

Connect Platforms

Team Permissions