Skip to main content
WoopSocial logo
  • Category: social media marketing
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 20
  • Triggers: 0
  • Slug: WOOP_SOCIAL
  • Version: 20261101_00

Tools

Slug: WOOP_SOCIAL_CREATE_DRAFT_POSTSave a post as a WoopSocial draft without publishing it externally. TikTok MEDIA_UPLOAD targets require human completion in TikTok if publication is later initiated. If enabled, media cleanup may permanently delete referenced WoopSocial media only after every delivery later publishes successfully.

Input Parameters

array
required
Exactly one content item containing text, media references, or both.
array
required
One or more unique platform-specific connected-account targets.
boolean
Delete referenced WoopSocial media after every delivery publishes successfully.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WOOP_SOCIAL_CREATE_PROJECTCreate a WoopSocial project in the API key’s organization.

Input Parameters

string
required
Human-readable name for the new WoopSocial project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WOOP_SOCIAL_DELETE_MEDIAPermanently delete one WoopSocial media-library item by its exact, explicitly supplied media ID. This operation cannot be undone. Never infer, guess, or automatically select the media ID.

Input Parameters

string
required
Exact media-library item ID to permanently delete. Never infer, guess, or select this ID from list order or other context.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WOOP_SOCIAL_DELETE_POSTPermanently delete a parent post by its exact ID. Deletion is allowed only while every social-account delivery is still NOT_STARTED; any delivery in another state causes a conflict and the post is not deleted. This operation cannot be undone.

Input Parameters

string
required
Exact parent post ID to permanently delete. Never infer, guess, or select this ID implicitly; numeric-looking IDs must remain strings.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WOOP_SOCIAL_DELETE_PROJECTPermanently delete a WoopSocial project by an exact, explicitly supplied project ID. This irreversible cascading deletion also permanently deletes the project’s social accounts, OAuth grants, media references, and posts. Never infer, guess, or automatically select the project ID.

Input Parameters

string
required
Exact project ID to permanently delete. Never infer, guess, or select this ID from a project name, list order, or any other context. Deleting the project also permanently deletes its social accounts, OAuth grants, media references, and posts.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WOOP_SOCIAL_DELETE_SOCIAL_ACCOUNTPermanently remove a connected social account from WoopSocial using its exact ID. This irreversible operation disconnects the account and revokes and deletes its stored OAuth grant and tokens. The connection cannot be recovered by this tool. Never infer or guess the social-account ID.

Input Parameters

string
required
Exact connected social-account ID to permanently remove. Never infer, guess, or select this ID implicitly. Deletion also revokes and deletes the connection’s stored OAuth grant and tokens.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WOOP_SOCIAL_DELETE_SOCIAL_ACCOUNT_POSTPermanently delete one social-account-specific post delivery using its exact delivery ID. The ID is distinct from the parent post ID.

Input Parameters

string
required
Exact social-account post delivery ID to permanently delete. This is the delivery ID, not its parent post ID; never infer or substitute it.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WOOP_SOCIAL_DELETE_WEBHOOKPermanently delete one WoopSocial webhook endpoint using its exact, explicitly supplied webhook ID. This operation cannot be undone. Never infer, guess, or automatically select the webhook ID.

Input Parameters

string
required
Exact webhook endpoint ID to permanently delete. Never infer, guess, or select this ID from webhook list order or other context.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WOOP_SOCIAL_GET_POSTGet a parent post and its per-social-account delivery records by post ID.

Input Parameters

string
required
Exact parent post ID returned by Create Post. Numeric-looking IDs must remain strings.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WOOP_SOCIAL_GET_SOCIAL_ACCOUNT_PLATFORM_INPUTSGet dynamic Pinterest board choices or TikTok posting-policy options for a connected social account before constructing a post target.

Input Parameters

string
required
Connected Pinterest or TikTok social-account ID, preserved as a string.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WOOP_SOCIAL_LIST_MEDIAList one page of WoopSocial media-library items, optionally filtered by project or exact media IDs.

Input Parameters

integer
Maximum number of media items to return in this page (1-100).
array
Exact media IDs to include.
string
Filter media to this exact project ID. Numeric-looking IDs must remain strings.
string
Opaque cursor from the previous response. Omit for the first page and pass it back unchanged to continue.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WOOP_SOCIAL_LIST_PROJECTSList all projects accessible to the connected WoopSocial API key.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WOOP_SOCIAL_LIST_SOCIAL_ACCOUNT_POSTSList one page of per-account post deliveries, optionally filtered by projects, social accounts, parent posts, platforms, or delivery statuses.

Input Parameters

integer
Maximum number of deliveries to return in this page (1-100).
array
Parent post IDs to include.
array
Social platforms to include.
string
Opaque cursor from the previous response. Omit for the first page and pass it back unchanged to continue.
array
Project IDs to include.
array
Delivery statuses to include: NOT_STARTED, SENDING, PUBLISHED, or FAILED.
array
Connected social-account IDs to include.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WOOP_SOCIAL_LIST_SOCIAL_ACCOUNTSList connected social accounts available for publishing, optionally within one project.

Input Parameters

string
Return only social accounts usable in this exact project. Numeric-looking project IDs must remain strings.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WOOP_SOCIAL_LIST_WEBHOOKSList registered WoopSocial webhook endpoints and their subscribed events. Signing secrets are not returned and cannot be recovered with this tool.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WOOP_SOCIAL_PUBLISH_POST_NOWPublish a post to external social platforms now; external publication is an irreversible action. TikTok MEDIA_UPLOAD requires a human to finish publication in TikTok instead of completing direct publication. If enabled, media cleanup permanently deletes referenced WoopSocial media after every delivery publishes successfully.

Input Parameters

array
required
Exactly one content item containing text, media references, or both.
array
required
One or more unique platform-specific connected-account targets.
boolean
Delete referenced WoopSocial media after every delivery publishes successfully.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WOOP_SOCIAL_REGISTER_WEBHOOKRegister a public HTTPS endpoint for WoopSocial publishing-success and/or publishing-failure events. The response contains a sensitive signing secret exactly once; capture and store it securely because it cannot be retrieved later.

Input Parameters

string
required
Publicly reachable HTTPS callback URL controlled by the caller.
array
required
Events to deliver. Include one or both exact values: socialAccountPost.delivery.published and socialAccountPost.delivery.failed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WOOP_SOCIAL_SCHEDULE_POSTSchedule automatic future publication to external social platforms; that future publication is irreversible. TikTok MEDIA_UPLOAD still requires a human to finish publication in TikTok. If enabled, media cleanup permanently deletes referenced WoopSocial media after every delivery publishes successfully.

Input Parameters

array
required
Exactly one content item containing text, media references, or both.
string
required
Future ISO-8601 UTC date-time when the post should be published.
array
required
One or more unique platform-specific connected-account targets.
boolean
Delete referenced WoopSocial media after every delivery publishes successfully.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WOOP_SOCIAL_UPLOAD_MEDIAUpload one image or video of at most 100 MB into a WoopSocial project using the atomic multipart endpoint.

Input Parameters

object
required
Image or video file to upload. WoopSocial accepts files up to 100 MB.
string
required
Project that will own the uploaded media.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WOOP_SOCIAL_VALIDATE_POSTValidate a proposed WoopSocial post without creating it, returning blocking errors and non-blocking warnings. The tool supports multiple account targets but does not accept Bluesky targets.

Input Parameters

array
required
Exactly one content item containing text, media references, or both.
string
required
Draft, immediate, or future scheduled publishing configuration.
array
required
One or more unique platform-specific connected-account targets.
boolean
Delete referenced WoopSocial media after every delivery publishes successfully.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not