Skip to main content
A profile represents one set of connected social accounts — typically a single brand, client, or sub-account you publish on behalf of. Profiles are the multi-tenant backbone of MADIAD Hub: one API key can manage many profiles, and every post targets exactly one. 
Your account (one API key)
├── profile: Acme Coffee   → Instagram, Facebook, TikTok
├── profile: Acme Tea      → Instagram, X
└── profile: Client — Nova → LinkedIn, YouTube

​
Create a profile

curl -X POST https://api.madiad.com/v1/profiles \
  -H "Authorization: Bearer $MADIAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "friendly_name": "Acme Coffee" }'

{
  "id": "prof_01HZX9F2K4M7N6QR8T0V2W4Y6Z",
  "friendly_name": "Acme Coffee",
  "connect_url": "https://connect.madiad.com/o/abc123def456",
  "created_at": "2026-05-31T08:00:00Z"
}
Use the returned id (prof_…) whenever you publish a post.

​
Connect social accounts

Each profile starts empty. Open its connect_url in a browser and sign in to every platform you want to publish to. MADIAD Hub stores the authorization, so you never handle platform tokens yourself.
1

Open the connect URL

Send the user (or yourself) to the connect_url returned when the profile was created.
2

Authorize each platform

Sign in to Instagram, Facebook, TikTok, and so on. Connections persist until revoked.
3

Publish

Reference the profile by id in any post request.

​
Supported platforms

A profile can connect any of: TikTok, Instagram, YouTube, Facebook, LinkedIn, X, Threads, Pinterest, Reddit, Bluesky, and Google Business Profile. A post only succeeds on platforms the target profile has actually connected. Listing a platform that isn’t connected returns an error for that platform.

​
When to use multiple profiles

  • Agencies — one profile per client.
  • Multi-brand teams — one profile per brand.
  • Environments — separate profiles for test vs production audiences.