API Reference
Explore the public UniPost API by resource. Each endpoint page includes authentication, parameters, responses, and runnable examples.
Profiles
Create and manage UniPost profiles that organize connected accounts and published content.
GETList profiles
/v1/profilesFetch profiles in the workspace.POSTCreate profile/v1/profilesCreate a profile for posting and analytics.GETGet profile/v1/profiles/{id}Fetch one profile by ID.PATCHUpdate profile/v1/profiles/{id}Update profile metadata.DELETEDelete profile/v1/profiles/{id}Remove a profile.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.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.Publishing
Create, schedule, validate, update, and inspect posts across connected destinations.
POSTCreate post
/v1/postsCreate or schedule a post.GETList posts/v1/postsList posts in a workspace.GETGet post/v1/posts/{id}Fetch a post and delivery results.PATCHUpdate post/v1/posts/{id}Edit post content or status.POSTValidate post/v1/posts/validateValidate platform-specific constraints.POSTCreate draft/v1/posts/draftsCreate a draft post.POSTPublish draft/v1/posts/{id}/publishPublish a draft.POSTReserve media upload/v1/mediaReserve upload storage for media.GETGet media/v1/media/{id}Fetch uploaded media metadata.POSTCreate audio overlay/v1/media/audio-overlaysCombine uploaded audio with an uploaded video.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.API Metrics
Inspect API-key traffic volume, latency, and status-code health for workspace Developer API calls.
GETOverall
/v1/api-metrics/overallRead aggregate API latency, volume, and error totals.GETSummary/v1/api-metrics/summaryList per-endpoint API latency and error rows.GETTrend/v1/api-metrics/trendRead hourly or daily API metrics buckets.GETStatus-Code/v1/api-metrics/status-codesRead exact status-code distribution by endpoint.Logs
Query, backfill, and stream workspace integration logs for API, publishing, OAuth, webhook, and worker activity.
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.