---
canonical_url: "https://docs.composio.dev/toolkits/woop_social"
markdown_url: "https://docs.composio.dev/toolkits/woop_social.md"
product: "platform"
version: null
last_updated: null
---

# WoopSocial

WoopSocial provides social media publishing, scheduling, media, project, account, and webhook management through its REST API.

- **Category:** social media marketing
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 20
- **Triggers:** 0
- **Slug:** `WOOP_SOCIAL`
- **Version:** 00000000_00

## Tools

### Create Draft Post

**Slug:** `WOOP_SOCIAL_CREATE_DRAFT_POST`

Save 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `content` | array | Yes | Exactly one content item containing text, media references, or both. |
| `social_accounts` | array | Yes | One or more unique platform-specific connected-account targets. |
| `auto_delete_media_after_publish` | boolean | No | Delete referenced WoopSocial media after every delivery publishes successfully. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Project

**Slug:** `WOOP_SOCIAL_CREATE_PROJECT`

Create a WoopSocial project in the API key's organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Human-readable name for the new WoopSocial project. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Media

**Slug:** `WOOP_SOCIAL_DELETE_MEDIA`

Permanently 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `media_id` | string | Yes | Exact media-library item ID to permanently delete. Never infer, guess, or select this ID from list order or other context. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Post

**Slug:** `WOOP_SOCIAL_DELETE_POST`

Permanently 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `post_id` | string | Yes | Exact parent post ID to permanently delete. Never infer, guess, or select this ID implicitly; numeric-looking IDs must remain strings. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Project

**Slug:** `WOOP_SOCIAL_DELETE_PROJECT`

Permanently 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | Yes | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Social Account

**Slug:** `WOOP_SOCIAL_DELETE_SOCIAL_ACCOUNT`

Permanently 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `social_account_id` | string | Yes | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Social Account Post

**Slug:** `WOOP_SOCIAL_DELETE_SOCIAL_ACCOUNT_POST`

Permanently delete one social-account-specific post delivery using its exact delivery ID. The ID is distinct from the parent post ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `social_account_post_id` | string | Yes | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Webhook

**Slug:** `WOOP_SOCIAL_DELETE_WEBHOOK`

Permanently 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `webhook_id` | string | Yes | Exact webhook endpoint ID to permanently delete. Never infer, guess, or select this ID from webhook list order or other context. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Post

**Slug:** `WOOP_SOCIAL_GET_POST`

Get a parent post and its per-social-account delivery records by post ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `post_id` | string | Yes | Exact parent post ID returned by Create Post. Numeric-looking IDs must remain strings. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Social Account Platform Inputs

**Slug:** `WOOP_SOCIAL_GET_SOCIAL_ACCOUNT_PLATFORM_INPUTS`

Get dynamic Pinterest board choices or TikTok posting-policy options for a connected social account before constructing a post target.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `social_account_id` | string | Yes | Connected Pinterest or TikTok social-account ID, preserved as a string. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Media

**Slug:** `WOOP_SOCIAL_LIST_MEDIA`

List one page of WoopSocial media-library items, optionally filtered by project or exact media IDs.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Projects

**Slug:** `WOOP_SOCIAL_LIST_PROJECTS`

List all projects accessible to the connected WoopSocial API key.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Social Account Posts

**Slug:** `WOOP_SOCIAL_LIST_SOCIAL_ACCOUNT_POSTS`

List one page of per-account post deliveries, optionally filtered by projects, social accounts, parent posts, platforms, or delivery statuses.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Social Accounts

**Slug:** `WOOP_SOCIAL_LIST_SOCIAL_ACCOUNTS`

List connected social accounts available for publishing, optionally within one project.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | No | Return only social accounts usable in this exact project. Numeric-looking project IDs must remain strings. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Webhooks

**Slug:** `WOOP_SOCIAL_LIST_WEBHOOKS`

List registered WoopSocial webhook endpoints and their subscribed events. Signing secrets are not returned and cannot be recovered with this tool.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Publish Post Now

**Slug:** `WOOP_SOCIAL_PUBLISH_POST_NOW`

Publish 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `content` | array | Yes | Exactly one content item containing text, media references, or both. |
| `social_accounts` | array | Yes | One or more unique platform-specific connected-account targets. |
| `auto_delete_media_after_publish` | boolean | No | Delete referenced WoopSocial media after every delivery publishes successfully. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Register Webhook

**Slug:** `WOOP_SOCIAL_REGISTER_WEBHOOK`

Register 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | Publicly reachable HTTPS callback URL controlled by the caller. |
| `event_types` | array | Yes | Events to deliver. Include one or both exact values: socialAccountPost.delivery.published and socialAccountPost.delivery.failed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Schedule Post

**Slug:** `WOOP_SOCIAL_SCHEDULE_POST`

Schedule 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `content` | array | Yes | Exactly one content item containing text, media references, or both. |
| `scheduled_for` | string | Yes | Future ISO-8601 UTC date-time when the post should be published. |
| `social_accounts` | array | Yes | One or more unique platform-specific connected-account targets. |
| `auto_delete_media_after_publish` | boolean | No | Delete referenced WoopSocial media after every delivery publishes successfully. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Upload Media

**Slug:** `WOOP_SOCIAL_UPLOAD_MEDIA`

Upload one image or video of at most 100 MB into a WoopSocial project using the atomic multipart endpoint.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file` | object | Yes | Image or video file to upload. WoopSocial accepts files up to 100 MB. |
| `project_id` | string | Yes | Project that will own the uploaded media. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Validate Post

**Slug:** `WOOP_SOCIAL_VALIDATE_POST`

Validate a proposed WoopSocial post without creating it. Returns blocking errors and non-blocking warnings for the complete multi-platform request.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `content` | array | Yes | Exactly one content item containing text, media references, or both. |
| `schedule` | string | Yes | Draft, immediate, or future scheduled publishing configuration. |
| `social_accounts` | array | Yes | One or more unique platform-specific connected-account targets. |
| `auto_delete_media_after_publish` | boolean | No | Delete referenced WoopSocial media after every delivery publishes successfully. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |