How do I install the Bundle Social Accounts skill?

Run npx skillmds@latest add antongulin/bundle-social-accounts in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Bundle Social Accounts safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Bundle Social Accounts?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Bundle Social Accounts free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Bundle Social Accounts?

antongulin (@antongulin) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Bundle Social Accounts by antongulin

Name: Bundle Social Accounts
Author: antongulin

Bundle Social Accounts

Manage Bundle.social social account connections across 14 platforms using the Bundle.social API. Use this skill when connecting, disconnecting, configuring channels, or managing social accounts on Bundle.social. Covers OAuth connection flow, disconnection, channel setup (Discord/Slack channels, Reddit subreddits), portal links, connection checks, profile refreshes, copying accounts between teams, and listing accounts by platform type. Supports Facebook, Instagram, TikTok, YouTube, Twitter/X, Pinterest, Reddit, Mastodon, Discord, Slack, Bluesky, Google Business, LinkedIn, and Threads. This skill should be triggered whenever a user says "connect", "disconnect", "social account", "OAuth", "channel", "portal link", or mentions linking any social media platform to Bundle.social.

antongulin Updated Sep 17, 2026

File contents

Author: Anton Gulin · Tool: opencode-skill-creator · GitHub: @antongulin · Registry: skills.sh

Bundle.social Social Accounts

This skill covers managing social account connections on Bundle.social — the critical bridge between Bundle.social and your social media platforms.

Authentication

All requests require the x-api-key header:

x-api-key: <your-api-key>

Base URL: https://api.bundle.social

Reference Docs

Read references/README.md for platform enums and error standards. Read references/04-social-account.md for all endpoint details.

How to Use This Skill

When a user asks about connecting or managing social accounts in Bundle.social:

Identify the platform — use the enum value from the platforms table in references/README.md
Read the reference doc for the specific operation (connect, disconnect, set channel, etc.)
Generate curl command examples with <your-api-key> as placeholder (NEVER call the API — you won't have credentials)
Explain OAuth flow when the user connects — the connect endpoint returns a URL they need to visit in a browser

Key Concepts

OAuth Connection Flow: The POST /api/v1/social-account/connect endpoint generates an OAuth URL. The user must visit this URL in a browser to authorize. Bundle.social doesn't store credentials — it uses OAuth tokens.
Channels: Discord servers/channels, Slack channels, Reddit subreddits are managed via set-channel/unset-channel endpoints.
Platform-specific fields: Mastodon/Bluesky need a serverUrl; Instagram supports instagramConnectionMethod (FACEBOOK or INSTAGRAM).

Endpoint Reference Summary

Connection

POST /api/v1/social-account/connect — Generate OAuth URL. Requires type, teamId, redirectUrl
DELETE /api/v1/social-account/disconnect — Disconnect and remove from scheduled posts

Channel Management

POST /api/v1/social-account/set-channel — Set channel (server/channel/subreddit)
POST /api/v1/social-account/unset-channel — Remove channel
POST /api/v1/social-account/refresh-channels — Refresh available channels

Maintenance

POST /api/v1/social-account/create-portal-link — Create portal link for account management
POST /api/v1/social-account/connection-check — Run connection/disconnect check
POST /api/v1/social-account/profile-refresh — Refresh profile info from platform

Queries

GET /api/v1/social-account/by-type — Get account by team + platform type
POST /api/v1/social-account/copy — Copy accounts to another team
GET /api/v1/social-account/to-delete — List accounts scheduled for deletion

Common Patterns

Full connection flow: Get org → Create team → Connect account (get OAuth URL) → User authorizes → Verify by getting account by type
Channel setup: Connect Discord/Slack/Reddit → Set channel → Refresh channels to confirm
Account maintenance: Periodically run connection checks and profile refreshes
Cleanup: Schedule disconnection, verify with to-delete list

Error Handling

400: Validation error — check the issues array for field-level errors
401: Check your API key
404: Account not found — verify the ID and team
Always check platform-specific error messages in the response

---name: bundle-social-accountsdescription: Manage Bundle.social social account connections across 14 platforms using the Bundle.social API. Use this skill when connecting, disconnecting, configuring channels, or managing social accounts on Bundle.social. Covers OAuth connection flow, disconnection, channel setup (Discord/Slack channels, Reddit subreddits), portal links, connection checks, profile refreshes, copying accounts between teams, and listing accounts by platform type. Supports Facebook, Instagram, TikTok, YouTube, Twitter/X, Pinterest, Reddit, Mastodon, Discord, Slack, Bluesky, Google Business, LinkedIn, and Threads. This skill should be triggered whenever a user says "connect", "disconnect", "social account", "OAuth", "channel", "portal link", or mentions linking any social media platform to Bundle.social.---> **Author**: Anton Gulin · **Tool**: [opencode-skill-creator](https://github.com/antongulin/opencode-skill-creator) · **GitHub**: [@antongulin](https://github.com/antongulin) · **Registry**: [skills.sh](https://www.skills.sh/docs)# Bundle.social Social AccountsThis skill covers managing social account connections on Bundle.social — the critical bridge between Bundle.social and your social media platforms.## AuthenticationAll requests require the `x-api-key` header:```x-api-key: <your-api-key>```Base URL: `https://api.bundle.social`## Reference DocsRead `references/README.md` for platform enums and error standards.Read `references/04-social-account.md` for all endpoint details.## How to Use This SkillWhen a user asks about connecting or managing social accounts in Bundle.social:1. **Identify the platform** — use the enum value from the platforms table in `references/README.md`2. **Read the reference doc** for the specific operation (connect, disconnect, set channel, etc.)3. **Generate curl command examples** with `<your-api-key>` as placeholder (NEVER call the API — you won't have credentials)4. **Explain OAuth flow** when the user connects — the connect endpoint returns a URL they need to visit in a browser### Key Concepts- **OAuth Connection Flow**: The `POST /api/v1/social-account/connect` endpoint generates an OAuth URL. The user must visit this URL in a browser to authorize. Bundle.social doesn't store credentials — it uses OAuth tokens.- **Channels**: Discord servers/channels, Slack channels, Reddit subreddits are managed via `set-channel`/`unset-channel` endpoints.- **Platform-specific fields**: Mastodon/Bluesky need a `serverUrl`; Instagram supports `instagramConnectionMethod` (FACEBOOK or INSTAGRAM).## Endpoint Reference Summary### Connection- `POST /api/v1/social-account/connect` — Generate OAuth URL. Requires `type`, `teamId`, `redirectUrl`- `DELETE /api/v1/social-account/disconnect` — Disconnect and remove from scheduled posts### Channel Management- `POST /api/v1/social-account/set-channel` — Set channel (server/channel/subreddit)- `POST /api/v1/social-account/unset-channel` — Remove channel- `POST /api/v1/social-account/refresh-channels` — Refresh available channels### Maintenance- `POST /api/v1/social-account/create-portal-link` — Create portal link for account management- `POST /api/v1/social-account/connection-check` — Run connection/disconnect check- `POST /api/v1/social-account/profile-refresh` — Refresh profile info from platform### Queries- `GET /api/v1/social-account/by-type` — Get account by team + platform type- `POST /api/v1/social-account/copy` — Copy accounts to another team- `GET /api/v1/social-account/to-delete` — List accounts scheduled for deletion## Common Patterns1. **Full connection flow**: Get org → Create team → Connect account (get OAuth URL) → User authorizes → Verify by getting account by type2. **Channel setup**: Connect Discord/Slack/Reddit → Set channel → Refresh channels to confirm3. **Account maintenance**: Periodically run connection checks and profile refreshes4. **Cleanup**: Schedule disconnection, verify with to-delete list## Error Handling- 400: Validation error — check the `issues` array for field-level errors- 401: Check your API key- 404: Account not found — verify the ID and team- Always check platform-specific error messages in the response

Frequently asked questions