API Reference

Explore the public UniPost API by resource. Each endpoint page includes authentication, parameters, responses, and runnable examples.

Accounts

Connect social accounts, inspect account health, and query account-level platform capabilities.

GETList accounts/v1/accountsList connected social accounts.POSTConnect account/v1/accounts/connectCreate an OAuth connection request.POSTOAuth connect/v1/oauth/connectStart an OAuth flow from API clients.DELETEDisconnect account/v1/accounts/{id}Disconnect a social account.GETAccount capabilities/v1/accounts/{id}/capabilitiesInspect publish and media support.GETX account profile/v1/accounts/{id}/profileRead the live profile for a connected X account.GETX authored posts/v1/accounts/{id}/postsRead a cursor-paginated page of posts authored by a connected X account.GETAccount health/v1/accounts/{id}/healthRead connection health and reconnect state.GETAccount metrics/v1/accounts/{id}/metricsRead platform account metrics.GETTikTok creator info/v1/accounts/{id}/tiktok/creator-infoFetch TikTok publishing limits.

Analytics

Build one normalized reporting workflow across Instagram, Threads, Pinterest, TikTok, and Facebook Page without integrating each platform separately.

GETWorkspace summary/v1/analytics/summaryRead workspace-level analytics cards.GETPost analytics/v1/posts/{post_id}/analyticsInspect one post's platform results.GETList analytics posts/v1/analytics/postsList normalized post-level analytics rows.GETExport analytics posts/v1/analytics/posts/exportDownload normalized post analytics as CSV.GETAnalytics rollup/v1/analytics/rollupRead time-bucketed metrics grouped by platform, account, or status.GETPlatform capabilities/v1/analytics/platformsList platform availability, metric coverage, and analytics health for the unified API.GETGet platform summary/v1/analytics/platforms/{platform}Read one platform's normalized summary, trend, accounts, and top posts.POSTRequest analytics refresh/v1/analytics/refreshMark matching rows stale for the refresh worker.

Connect Sessions

Create branded account-connection sessions for embedded and white-label onboarding flows.

Workspace, Users, And Webhooks

Inspect workspace settings, sync managed users, and subscribe external systems to UniPost events.

GETGet workspace/v1/workspaceFetch workspace metadata.PATCHUpdate workspace/v1/workspaceUpdate workspace metadata.POSTUpload platform credentials/v1/platform-credentialsSave workspace-owned platform OAuth credentials.GETList platform credentials/v1/platform-credentialsList configured platform OAuth credentials.DELETEDelete platform credentials/v1/platform-credentials/{platform}Remove workspace-owned platform OAuth credentials.GETList users/v1/usersList managed users.GETGet user/v1/users/{external_user_id}Fetch one managed user.POSTCreate webhook/v1/webhooksCreate a webhook subscription.GETList webhooks/v1/webhooksList webhook subscriptions.GETGet webhook/v1/webhooks/{id}Fetch one webhook subscription.PATCHUpdate webhook/v1/webhooks/{id}Update webhook subscription settings.POSTRotate webhook secret/v1/webhooks/{id}/rotateRotate a webhook signing secret.