Wahdx Connection

Developer documentation

API docs for multi-platform publishing and analytics workflows.

Start with authentication, connected account discovery, media requirements, photo carousel payloads, status tracking, TikTok QR login, and analytics endpoints. Each guide is structured for server-side integrations and content team workflows.

Get API Access Start With Auth

Server-side quick start

Keep API keys in your backend or serverless environment. Do not expose keys in browser code.

const API_BASE_URL = 'https://api.wahdx.com';
const API_KEY = process.env.WAHDX_API_KEY;

await fetch(API_BASE_URL + '/api/content/post', {
  method: 'POST',
  headers: {
    'X-API-Key': API_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(
    {
      "platform": "instagram",
      "accountId": "YOUR_CONNECTED_ACCOUNT_ID",
      "content": "Campaign caption",
      "mediaItems": [
        {
          "url": "https://your-domain.com/video.mp4"
        }
      ]
    }
  )
});

import os
import requests

API_BASE_URL = 'https://api.wahdx.com'
API_KEY = os.environ['WAHDX_API_KEY']

response = requests.post(
    API_BASE_URL + '/api/content/post',
    headers={
        'X-API-Key': API_KEY,
        'Content-Type': 'application/json',
    },
    json={
    'platform': 'instagram',
    'accountId': 'YOUR_CONNECTED_ACCOUNT_ID',
    'content': 'Campaign caption',
    'mediaItems': [
        {
            'url': 'https://your-domain.com/video.mp4'
        }
    ]
},
    timeout=30,
)

response.raise_for_status()
print(response.json())

curl -X POST "https://api.wahdx.com/api/content/post" \
  -H "X-API-Key: $WAHDX_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{
  "platform": "instagram",
  "accountId": "YOUR_CONNECTED_ACCOUNT_ID",
  "content": "Campaign caption",
  "mediaItems": [
    {
      "url": "https://your-domain.com/video.mp4"
    }
  ]
}'

Endpoint model

Video and photo carousel use the same publishing endpoint.

The difference is not the endpoint. Use POST /api/content/post for TikTok, Instagram, Facebook, and Threads. The backend detects video or photo carousel from mediaItems URL extensions, then validates limits for the selected platform.

Video samples Photo carousel samples

// Video and photo carousel use the SAME endpoint:
// POST /api/content/post

const videoPayload = {
  "platform": "tiktok",
  "accountId": "CONNECTED_ACCOUNT_ID",
  "content": "Video caption",
  "mediaItems": [
    {
      "url": "https://your-domain.com/video.mp4"
    }
  ]
};

const photoCarouselPayload = {
  "platform": "tiktok",
  "accountId": "CONNECTED_ACCOUNT_ID",
  "photoTitle": "Carousel title",
  "content": "Carousel caption",
  "mediaItems": [
    {
      "url": "https://your-domain.com/photo-1.jpg"
    },
    {
      "url": "https://your-domain.com/photo-2.jpg"
    }
  ]
};

# Video and photo carousel use the SAME endpoint:
# POST /api/content/post

video_payload = {
    'platform': 'tiktok',
    'accountId': 'CONNECTED_ACCOUNT_ID',
    'content': 'Video caption',
    'mediaItems': [
        {
            'url': 'https://your-domain.com/video.mp4'
        }
    ]
}

photo_carousel_payload = {
    'platform': 'tiktok',
    'accountId': 'CONNECTED_ACCOUNT_ID',
    'photoTitle': 'Carousel title',
    'content': 'Carousel caption',
    'mediaItems': [
        {
            'url': 'https://your-domain.com/photo-1.jpg'
        },
        {
            'url': 'https://your-domain.com/photo-2.jpg'
        }
    ]
}

# Video request: exactly one video URL in mediaItems
curl -X POST "https://api.wahdx.com/api/content/post" \
  -H "X-API-Key: $WAHDX_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{
  "platform": "tiktok",
  "accountId": "CONNECTED_ACCOUNT_ID",
  "content": "Video caption",
  "mediaItems": [
    {
      "url": "https://your-domain.com/video.mp4"
    }
  ]
}'

# Photo carousel request: multiple image URLs in mediaItems
curl -X POST "https://api.wahdx.com/api/content/post" \
  -H "X-API-Key: $WAHDX_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{
  "platform": "tiktok",
  "accountId": "CONNECTED_ACCOUNT_ID",
  "photoTitle": "Carousel title",
  "content": "Carousel caption",
  "mediaItems": [
    {
      "url": "https://your-domain.com/photo-1.jpg"
    },
    {
      "url": "https://your-domain.com/photo-2.jpg"
    }
  ]
}'

Core docs

Read the API topics that should be linked from every integration plan.

API authentication

Authenticate Wahdx Connection API Requests

Learn how to authenticate Wahdx Connection API requests with X-API-Key and keep keys secure in backend or server-side environments.

Connected accounts API

List Connected Social Accounts with the Public API

Use GET /api/content/accounts to list TikTok, Instagram, Threads, and Facebook accounts connected to a Wahdx Connection workspace using an API key.

Video publishing requirements

Video Requirements for Social Publishing API Workflows

Review recommended video formats, size, duration, aspect ratio, and thumbnail settings for Wahdx Connection publishing workflows.

Photo carousel publishing

Photo Carousel Publishing API Guide

Learn how to prepare photo carousel posts, cover images, title fields, and media arrays for Wahdx Connection publishing workflows.

Text-only posting

Text-Only Post API for Threads and Facebook

Publish text-only posts with no media to Threads and Facebook Pages using the Wahdx Connection API, immediately or on a schedule.

Threads text & thread sequence

Threads Text Post & Thread Sequence API

Post text-only updates and linked thread sequences to Threads using Wahdx Connection API.

Post status tracking

Track Social Post Status with Wahdx Connection API

Check individual or batch post status for social publishing workflows and monitor queued, processing, published, or failed content.

QR login workflow

TikTok QR Login API Workflow

Learn the QR login request, display, polling, and account-linking flow for TikTok account connection workflows.

Publishing analytics API

Publishing Analytics with the Wahdx Connection API

Use GET /api/analytics/publishing to inspect request-level and provider-item-level publishing metrics from the Wahdx Connection ledger.

Platform guides

Connect docs to real platform workflows.

TikTok Publishing API for Content Teams

Connect TikTok accounts through official access flows, prepare video or photo posts, schedule content, and monitor post status from one API-first workflow.

Instagram Publishing API Workflow for Brands and Agencies

Prepare Instagram publishing workflows for business and creator accounts with account selection, media handling, scheduling, and status visibility.

Threads Publishing Workflow for Multi-Platform Content Teams

Publish Threads content from the same controlled workflow used for TikTok, Instagram, and Facebook campaigns.

Facebook Publishing API Workflow for Business Content

Coordinate Facebook publishing with the same scheduling, account selection, and post status workflow used across your content operation.

Use-case guides

Build around scheduling, publishing, status visibility, and analytics.

Social Media Scheduling API for Multi-Platform Teams

Schedule social content across TikTok, Instagram, Threads, and Facebook with one API-first workflow and clear post status tracking.

Multi-Platform Posting Workflow for Content Businesses

Post to multiple social platforms from one workflow built for agencies, brands, internal teams, and developer integrations.

Content Publishing API for Social Media Workflows

Use a business-ready content publishing API to prepare, publish, schedule, and monitor social posts across supported platforms.

Social Media Post Status Tracking API

Track social post status across publishing workflows so teams can identify queued, processing, published, or failed content faster.

Publishing Analytics for Multi-Platform Content Teams

Measure publishing volume, provider acceptance, publication, and failure rates per platform with aggregate publishing analytics.

Social Media Analytics API for Reach, Engagement, and Growth

Measure reach, engagement, followers, top content, and publishing outcomes across TikTok, Instagram, Threads, and Facebook with per-platform analytics.