# WoopSocial

```json
{
  "name": "WoopSocial",
  "slug": "woop_social",
  "url": "https://composio.dev/toolkits/woop_social",
  "markdown_url": "https://composio.dev/toolkits/woop_social.md",
  "logo_url": "https://logos.composio.dev/api/woopsocial",
  "categories": [
    "marketing & social media"
  ],
  "is_composio_managed": false,
  "updated_at": "2026-08-20T15:34:48.360Z"
}
```

![WoopSocial logo](https://logos.composio.dev/api/woopsocial)

## Description

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with WoopSocial MCP or direct API to publish social posts, schedule campaigns, manage media, and monitor webhooks through natural language.

## Summary

WoopSocial is a social media management API for publishing, scheduling, media, projects, accounts, and webhooks.
It helps teams manage social workflows from one programmable platform.

## Categories

- marketing & social media

## Toolkit Details

- Tools: 20

## Images

- Logo: https://logos.composio.dev/api/woopsocial

## Authentication

- **Api Key**
  - Type: `api_key`
  - Description: Api Key authentication for WoopSocial.
  - Setup:
    - Configure Api Key credentials for WoopSocial.
    - Use the credentials when creating an auth config in Composio.

## Suggested Prompts

- Schedule posts across social accounts
- Upload campaign media to WoopSocial
- List projects and connected accounts

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `WOOP_SOCIAL_CREATE_DRAFT_POST` | 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. |
| `WOOP_SOCIAL_CREATE_PROJECT` | Create Project | Create a WoopSocial project in the API key's organization. |
| `WOOP_SOCIAL_DELETE_MEDIA` | 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. |
| `WOOP_SOCIAL_DELETE_POST` | 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. |
| `WOOP_SOCIAL_DELETE_PROJECT` | 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. |
| `WOOP_SOCIAL_DELETE_SOCIAL_ACCOUNT` | 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. |
| `WOOP_SOCIAL_DELETE_SOCIAL_ACCOUNT_POST` | 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. |
| `WOOP_SOCIAL_DELETE_WEBHOOK` | 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. |
| `WOOP_SOCIAL_GET_POST` | Get Post | Get a parent post and its per-social-account delivery records by post ID. |
| `WOOP_SOCIAL_GET_SOCIAL_ACCOUNT_PLATFORM_INPUTS` | 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. |
| `WOOP_SOCIAL_LIST_MEDIA` | List Media | List one page of WoopSocial media-library items, optionally filtered by project or exact media IDs. |
| `WOOP_SOCIAL_LIST_PROJECTS` | List Projects | List all projects accessible to the connected WoopSocial API key. |
| `WOOP_SOCIAL_LIST_SOCIAL_ACCOUNT_POSTS` | List Social Account Posts | List one page of per-account post deliveries, optionally filtered by projects, social accounts, parent posts, platforms, or delivery statuses. |
| `WOOP_SOCIAL_LIST_SOCIAL_ACCOUNTS` | List Social Accounts | List connected social accounts available for publishing, optionally within one project. |
| `WOOP_SOCIAL_LIST_WEBHOOKS` | List Webhooks | List registered WoopSocial webhook endpoints and their subscribed events. Signing secrets are not returned and cannot be recovered with this tool. |
| `WOOP_SOCIAL_PUBLISH_POST_NOW` | 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. |
| `WOOP_SOCIAL_REGISTER_WEBHOOK` | 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. |
| `WOOP_SOCIAL_SCHEDULE_POST` | 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. |
| `WOOP_SOCIAL_UPLOAD_MEDIA` | Upload Media | Upload one image or video of at most 100 MB into a WoopSocial project using the atomic multipart endpoint. |
| `WOOP_SOCIAL_VALIDATE_POST` | Validate Post | Validate a proposed WoopSocial post without creating it. Returns blocking errors and non-blocking warnings for the complete multi-platform request. |

## Supported Triggers

None listed.

## Installation and MCP Setup

### Path 1: SDK Installation

#### Path 1, Step 1: Install Composio

Install the Composio SDK
```python
pip install composio_openai
```

```typescript
npm install @composio/openai
```

#### Path 1, Step 2: Initialize Composio and Create Tool Router Session

Import and initialize Composio client, then create a Tool Router session
```python
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
openai = OpenAI()
session = composio.create(user_id='your-user-id')
```

```typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
```

#### Path 1, Step 3: Execute WoopSocial Tools via Tool Router with Your Agent

Get tools from Tool Router session and execute WoopSocial actions with your Agent
```python
tools = session.tools
response = openai.responses.create(
  model='gpt-4.1',
  tools=tools,
  input=[{
    'role': 'user',
    'content': 'List my WoopSocial projects and connected social accounts'
  }]
)
result = composio.provider.handle_tool_calls(
  response=response,
  user_id='your-user-id'
)
print(result)
```

```typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'List my WoopSocial projects and connected social accounts'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
```

### Path 2: MCP Server Setup

#### Path 2, Step 1: Install Composio

Install the Composio SDK for Python or TypeScript
```python
pip install composio claude-agent-sdk
```

```typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
```

#### Path 2, Step 2: Initialize Client and Create Tool Router Session

Import and initialize the Composio client, then create a Tool Router session for WoopSocial
```python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
```

```typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
```

#### Path 2, Step 3: Connect to AI Agent

Use the MCP server with your AI agent (Anthropic Claude or Mastra)
```python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to WoopSocial tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('List my WoopSocial projects and connected social accounts')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
```

```typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'List my WoopSocial projects and connected social accounts'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
```

## Why Use Composio?

### 1. AI Native WoopSocial Integration

- Supports both WoopSocial MCP and direct API based integrations
- Structured, LLM-friendly schemas for reliable social publishing and scheduling
- Rich coverage for posts, media, projects, accounts, and webhook workflows

### 2. Managed Auth

- Secure API key handling without hard-coding WoopSocial credentials in your agent code
- Central place to manage, scope, and revoke WoopSocial access
- Per user and per environment credentials so teams can ship safely

### 3. Agent Optimized Design

- Tools are tuned for AI agents, so publishing, scheduling, and media actions are easier to call correctly
- Comprehensive execution logs so you always know what ran, when, and on whose behalf

### 4. Enterprise Grade Security

- Fine-grained RBAC so you control which agents and users can access WoopSocial
- Scoped, least privilege access to WoopSocial resources
- Full audit trail of agent actions to support review and compliance

## Use WoopSocial with any AI Agent Framework

Choose a framework you want to connect WoopSocial with:

None listed.

## Related Toolkits

- [Reddit](https://composio.dev/toolkits/reddit) - Reddit is a social news platform with thriving user-driven communities (subreddits). It's the go-to place for discussion, content sharing, and viral marketing.
- [Facebook](https://composio.dev/toolkits/facebook) - Facebook is a social media and advertising platform for businesses and creators. It helps you connect, share, and manage content across your public Facebook Pages.
- [Linkedin](https://composio.dev/toolkits/linkedin) - LinkedIn is a professional networking platform for connecting, sharing content, and engaging with business opportunities. It's the go-to place for building your professional brand and unlocking new career connections.
- [Active campaign](https://composio.dev/toolkits/active_campaign) - ActiveCampaign is a marketing automation and CRM platform for managing email campaigns, sales pipelines, and customer segmentation. It helps businesses engage customers and drive growth through smart automation and targeted outreach.
- [ActiveTrail](https://composio.dev/toolkits/active_trail) - ActiveTrail is a user-friendly email marketing and automation platform. It helps you reach subscribers and automate campaigns with ease.
- [Ahrefs](https://composio.dev/toolkits/ahrefs) - Ahrefs is an SEO and marketing platform for site audits, keyword research, and competitor insights. It helps you improve search rankings and drive organic traffic.
- [AimTell](https://composio.dev/toolkits/aimtell) - AimTell is a web push notification platform for managing websites, subscribers, campaigns, segments, and delivery analytics. Use it to send targeted browser notifications and measure engagement across your web push campaigns.
- [Amcards](https://composio.dev/toolkits/amcards) - AMCards lets you create and mail personalized greeting cards online. Build stronger customer relationships with easy, automated card campaigns.
- [Beamer](https://composio.dev/toolkits/beamer) - Beamer is a news and changelog platform for in-app announcements and feature updates. It helps companies boost user engagement by sharing news where users are most active.
- [Benchmark email](https://composio.dev/toolkits/benchmark_email) - Benchmark Email is a platform for creating, sending, and tracking email campaigns. It's built to help you engage audiences and analyze results—all in one place.
- [Bigmailer](https://composio.dev/toolkits/bigmailer) - BigMailer is an email marketing platform for managing multiple brands with white-labeling and automation. It helps teams streamline campaigns and simplify integration with Amazon SES.
- [Bitly](https://composio.dev/toolkits/bitly) - Bitly is a link management platform for shortening, customizing, sharing, and tracking links and QR codes. It helps teams create branded links and measure engagement across campaigns.
- [Brandfetch](https://composio.dev/toolkits/brandfetch) - Brandfetch is an API that delivers company logos, colors, and visual branding assets. It helps marketers and developers keep brand visuals consistent everywhere.
- [Brevo](https://composio.dev/toolkits/brevo) - Brevo is an all-in-one email and SMS marketing platform for transactional messaging, automation, and CRM. It helps businesses engage customers and streamline communications through powerful campaign tools.
- [Buffer](https://composio.dev/toolkits/buffer) - Buffer is a social media management platform for planning, creating, scheduling, and publishing posts across connected channels. It helps teams keep content organized and publish consistently without jumping between social apps.
- [BulkPublish](https://composio.dev/toolkits/bulkpublish) - BulkPublish is a social media publishing platform for managing scheduled content across multiple channels. It helps teams plan campaigns, publish consistently, and track performance in one place.
- [Campayn](https://composio.dev/toolkits/campayn) - Campayn is an email marketing platform for creating, sending, and managing campaigns. It helps businesses engage contacts and grow audiences with easy-to-use tools.
- [Cardly](https://composio.dev/toolkits/cardly) - Cardly is a platform for creating and sending personalized direct mail to customers. It helps businesses break through the digital clutter by getting real engagement via physical mailboxes.
- [ClickSend](https://composio.dev/toolkits/clicksend) - ClickSend is a cloud-based SMS and email marketing platform for businesses. It streamlines communication by enabling quick message delivery and contact management.
- [Constant Contact](https://composio.dev/toolkits/constant_contact) - Constant Contact is an email marketing and automation platform for small businesses. It helps teams build campaigns, manage contacts, and grow customer relationships.

## Frequently Asked Questions

### Do I need my own developer credentials to use WoopSocial with Composio?

Yes, WoopSocial requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

### Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview).

### Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev).

### What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)