How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
woopsocial-com

woopsocial-com Openapi API

This is the public-facing OpenAPI contract for WoopSocial. It supports scheduling posts for various social media platforms suchas Bluesky, Facebook, Instagram, LinkedIn, LinkedIn Pages, Pinterest, Threads, TikTok, X (formerly Twitter) and YouTube.

Documentation Provider Profile APIs.io OpenAPI GitHub

woopsocial-com Openapi API is one of 3 APIs that woopsocial-com publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 6 JSON Schema definitions.

The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

This API exposes 24 operations across 20 paths, organized into 7 resource areas, and defines 125 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against 2 base URLs: https://api.woopsocial.com/v1, http://localhost:9123/api/external/v1.

24 operations 20 paths 125 schemas 6 DELETE9 GET9 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://api.woopsocial.com/v1
Authentication
HTTP Bearer
Resource Areas
7

Authentication & Security 1

woopsocial-com Openapi API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (API key) (ApiKey).

Paths & Operations 24

Across 20 paths, the API surfaces 24 operations — 6 DELETE, 9 GET, 9 POST. They span 7 resource areas: Posts, Projects, Social Accounts, Media, Webhooks, Feedback, Health. Each is listed below with its method, path, parameters, and response codes.

Posts 6

Post scheduling endpoints.

POST
/posts
Create post
createPost body → 201422429500
POST
/posts/validate
Validate post
validatePost body → 200429500
GET
/posts/{postId}
Get post
getPost 1 param → 200404429500
DELETE
/posts/{postId}
Delete post
deletePost 1 param → 204404409429500
GET
/social-account-posts
List social account posts
listSocialAccountPosts 7 params → 200429
DELETE
/social-account-posts/{socialAccountPostId}
Delete social account post
deleteSocialAccountPost 1 param → 204404429500
Projects 3

Project discovery endpoints.

POST
/projects
Create project
createProject body → 201429
GET
/projects
List projects
listProjects → 200429
DELETE
/projects/{projectId}
Delete project
deleteProject 1 param → 204429
Social Accounts 4

Connected social account discovery endpoints.

POST
/social-accounts/authorization-url
Generate OAuth URL
createOAuthAuthorization body → 200429
GET
/social-accounts
List social accounts
listSocialAccounts 1 param → 200429
DELETE
/social-accounts/{socialAccountId}
Delete social account
deleteSocialAccount 1 param → 204404429500
GET
/social-accounts/{socialAccountId}/platform-inputs
Get platform-specific input options
getSocialAccountPlatformInputs 1 param → 200429
Media 6

Media upload endpoints.

GET
/media
List media
listMedia 4 params → 200429
POST
/media
Upload media
createMedia 1 param body → 200429
DELETE
/media/{mediaId}
Delete media
deleteMedia 1 param → 204404429500
POST
/media/upload-sessions
Start media upload session
createUploadSession body → 200429
GET
/media/upload-sessions/{uploadSessionId}
Get media upload session status
getUploadSession 1 param → 200429
POST
/media/upload-sessions/{uploadSessionId}/complete
Complete media upload session
completeUploadSession 1 param → 200429
Webhooks 3

Webhook endpoint management.

POST
/webhooks
Register webhook endpoint
createWebhookEndpoint body → 201422429
GET
/webhooks
List webhook endpoints
listWebhookEndpoints → 200429
DELETE
/webhooks/{webhookId}
Delete webhook endpoint
deleteWebhookEndpoint 1 param → 204404429
Feedback 1

Send product feedback to the WoopSocial team.

POST
/feedback
Send feedback
sendFeedback body → 200429
Health 1

Basic connectivity endpoints.

GET
/health
Health check
getHealth → 200429

Schemas 125

The contract defines 125 schemas that model the data the API accepts and returns. The most detailed are SocialAccountPostBase (14 properties), TikTokFields (11 properties), PostAnalytics (10 properties), WebhookEvent (9 properties). Each schema is shown below with its type and property counts.

FeedbackCategory
string
What the note is about.
SendFeedbackRequest
object
2 properties 2 required
SendFeedbackResponse
object
1 property 1 required
FeedbackLimitErrorResponse
object
1 property 1 required
ConcurrencyLimitErrorCode
string
ConcurrencyLimitErrorResponse
object
2 properties 2 required
WebhookEventType
string
CreateWebhookEndpointRequest
object
2 properties 2 required
WebhookEndpoint
object
5 properties 4 required
WebhookEvent
object
Payload delivered to registered webhook URLs.
9 properties 6 required
Project
object
2 properties 2 required
CreateProjectRequest
object
1 property 1 required
SocialAccountStatus
string
SocialPlatform
string
Identifies which social media platform this data structure targets.
CreateOAuthAuthorizationRequest
object
3 properties 2 required
OAuthCallbackErrorCode
string
Error code appended to redirectUrl as the error query parameter when OAuth fails after WoopSocial has recovered the callback state. facebooknopages means Faceb…
CreateOAuthAuthorizationResponse
object
1 property 1 required
SocialAccount
object
6 properties 6 required
SocialAccountPlatformInputs
object
2 properties 2 required
SocialAccountPlatformSpecificInputs
PinterestSocialAccountPlatformSpecificInputs
object
2 properties 2 required
TikTokSocialAccountPlatformSpecificInputs
object
6 properties 6 required
PinterestBoardOption
object
2 properties 2 required
DeliveryStatus
string
Delivery lifecycle status for a post. NOTSTARTED: The post exists and is scheduled, but delivery has not started yet. SENDING: Delivery is currently in progres…
PostContentMediaInput
Content media reference.
MediaLibraryPostContentMediaInput
object
2 properties 2 required
PostContentMedia
Resolved content media.
MediaLibraryPostContentMedia
object
5 properties 5 required
PostContentItemInput
object
2 properties
PostContentItem
object
2 properties
PostContentInput
array
Post content expressed as thread items. The array exists for future thread support. Currently exactly one item is supported.
PostContent
array
Post content expressed as thread items. The array exists for future thread support. Currently exactly one item is returned.
PostSchedule
When the post should be published.
DraftPostSchedule
object
1 property 1 required
PublishNowPostSchedule
object
1 property 1 required
ScheduleForLaterPostSchedule
object
2 properties 2 required
PostRetryPolicy
object
Automatically creates a scheduled retry post for each failed target. Successful targets are never copied. Known failures requiring user intervention, such as i…
2 properties 2 required
CreatePostRequest
object
5 properties 3 required
Post
object
9 properties 8 required
ListSocialAccountPostsResponse
object
2 properties 1 required
MediaType
string
Media
object
5 properties 5 required
ListMediaResponse
object
2 properties 1 required
CreateMediaResponse
object
1 property 1 required
CreateUploadSessionRequest
object
2 properties 2 required
UploadSessionPart
object
2 properties 2 required
UploadSession
object
5 properties 5 required
UploadSessionStatus
UploadSessionInitiatedStatus
object
2 properties 2 required
UploadSessionUploadedStatus
object
2 properties 2 required
UploadSessionReadyStatus
object
3 properties 3 required
UploadSessionFailedStatus
object
4 properties 4 required
UploadSessionAbortedStatus
object
2 properties 2 required
SocialAccountInput
SocialAccountInputBase
object
2 properties 1 required
SocialAccountPostBase
object
14 properties 10 required
PostAnalytics
object
Latest stored lifetime metrics for this social account post. Each supported metric contains its latest snapshot, or an empty array if no observation exists. Un…
10 properties
PostAnalyticsSnapshots
array
PostAnalyticsSnapshot
object
3 properties 3 required
PinterestPlatform
object
1 property 1 required
InstagramPlatform
object
1 property 1 required
FacebookPlatform
object
1 property 1 required
TikTokPlatform
object
1 property 1 required
ThreadsPlatform
object
1 property 1 required
BlueskyPlatform
object
1 property 1 required
YouTubePlatform
object
1 property 1 required
XPlatform
object
1 property 1 required
LinkedInPlatform
object
1 property 1 required
LinkedInPagesPlatform
object
1 property 1 required
PinterestFields
object
3 properties 1 required
InstagramFields
object
3 properties 1 required
FacebookFields
object
3 properties 1 required
LinkedInFields
object
1 property
TikTokFields
object
11 properties 7 required
YouTubeFields
object
5 properties 2 required
PinterestInput
InstagramInput
FacebookInput
TikTokInput
ThreadsInput
BlueskyInput
YouTubeInput
XInput
LinkedInInput
LinkedInPagesInput
SocialAccountPost
PinterestPost
InstagramPost
FacebookPost
TikTokPost
ThreadsPost
BlueskyPost
YouTubePost
XPost
LinkedInPost
LinkedInPagesPost
WoopTestPlatform
object
1 property 1 required
WoopTestFields
object
1 property
WoopTestInput
WoopTest is a sandbox platform for testing and debugging. Posts targeting WOOPTEST go through the full scheduling pipeline but are never published to any real…
WoopTestPost
ValidationError
object
3 properties 2 required
ValidationWarning
object
3 properties 2 required
ValidationField
string
CreatePostErrorCode
string
CreatePostErrorResponse
object
4 properties 2 required
ValidatePostResponse
object
3 properties 3 required
GetPostErrorCode
string
GetPostErrorResponse
object
2 properties 2 required
DeletePostErrorCode
string
DeletePostErrorResponse
object
2 properties 2 required
DeleteSocialAccountPostErrorCode
string
DeleteSocialAccountPostErrorResponse
object
2 properties 2 required
DeleteSocialAccountErrorCode
string
DeleteSocialAccountErrorResponse
object
2 properties 2 required
DeleteMediaErrorCode
string
DeleteMediaErrorResponse
object
2 properties 2 required
InstagramPostType
string
InstagramTrialParams
object
1 property 1 required
InstagramTrialGraduationStrategy
string
Controls how a Trial Reel graduates to followers. MANUAL leaves graduation to the user in Instagram. SSPERFORMANCE lets Instagram graduate the Reel automatical…
FacebookPostType
string
TikTokPrivacyLevel
string
TikTokPostType
string
TikTokPostMode
string
YouTubePrivacy
string
HealthResponse
object
3 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

woopsocial-com-openapi-openapi.yml Raw ↑

Other APIs woopsocial-com publishes across the network.

WoopSocial API
AE Profile APIs.io
woopsocial-com Out.Openapi API
AE Profile APIs.io
← Back to W APIs
API Details
ID
woopsocial-com:woopsocial-com-openapi-api
Base URL
https://api.woopsocial.com/v1
Docs
https://github.com/WoopSocial/docs
Provider
woopsocial-com
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=woopsocial-com-openapi-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/woopsocial-com-openapi-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of woopsocial-com Openapi API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.