How to Build a White-Label Social Media Tool with CodivUpload's API

What is the whitelabel API?

The core idea is straightforward: your brand sits in front of the client, and CodivUpload's engine runs behind the scenes. Every API response, every connection page, every redirect URL — none of it mentions CodivUpload. Your clients see your company name, your logo, and your domain. They never encounter ours.

This isn't a separate add-on or an enterprise-only feature gated behind a sales call. Whitelabel access is included in every Pro plan ($45/mo) and above. You get the full API surface — 50+ parameters for fine-grained control over posts, platform-specific overrides, media handling, and scheduling — without writing a single OAuth integration yourself.

The whitelabel API serves three primary audiences, each with a different motivation:

How the branded connection flow works

The connection flow is how your clients authorize their social accounts without ever seeing CodivUpload. It uses a JWT-based share link that you generate from the dashboard or via the API. Here's the full sequence:

Every element of the connection page is customizable. Here are the fields you control:

The whitelabel flow at a glance

Three screens, three perspectives. Here's what each party sees during the connection process — from your dashboard to the client's branded page.

Publishing on behalf of clients via the API

Once a client has connected their accounts through your branded link, you can publish to their platforms with a single API call. The profile_name field identifies which client profile to publish under. CodivUpload handles token selection, platform-specific formatting, and media delivery for each target network.

Here's a typical publish call. This posts the same video to TikTok, Instagram Reels, and LinkedIn — each platform receives the content in its native format:

{
  "profile_name": "acme-corp-social",
  "platforms": ["tiktok", "instagram", "linkedin"],
  "media_urls": ["https://cdn.acmecorp.com/q3-recap.mp4"],
  "description": "Q3 results: 847K revenue, 23% growth."
}

The API supports 50+ parameters for platform-specific overrides — Instagram alt text, YouTube privacy status, TikTok disclosure settings, LinkedIn article URLs, Pinterest board targeting, and more. Every parameter is documented in the API reference.

You can also generate branded connection links programmatically. This is useful if you're building an onboarding flow in your own product and want to create the link server-side:

{
  "username": "client_brand",
  "platforms": ["youtube", "tiktok", "instagram"],
  "logo_image": "https://yourdomain.com/logo.png",
  "redirect_url": "https://yourdomain.com/onboarding/success",
  "connect_title": "Connect Your Channels",
  "connect_description": "Link your social accounts to start publishing.",
  "redirect_button_text": "Back to Dashboard",
  "youtube_client_id": "123456789.apps.googleusercontent.com",
  "youtube_client_secret": "GOCSPX-xxxxxxxxxxxx"
}

The username field identifies which profile to bind the connection to. All fields except username are optional — but logo_image and redirect_url are required for a properly branded experience.

{
  "success": true,
  "access_url": "https://app.codivupload.com/connect?token=eyJhbGciOiJI...",
  "expires_in": 172800
}

Pricing — flat rate, no per-client fees

One of the most common questions about whitelabel APIs is whether there's a per-client or per-connection surcharge. With CodivUpload, there isn't. You pay for a plan, the plan includes a set number of profiles, and whitelabel is bundled in. No separate line item, no usage-based billing surprises.

What the whitelabel API includes

This isn't a stripped-down "whitelabel tier" with limited functionality. Every whitelabel customer gets the full platform. Here's what that means concretely:

Common questions

Further reading