# bundle.social

## Docs

- [Welcome](https://info.bundle.social/welcome.md): The Unified Social Media API. Write once, post everywhere: one integration for 15+ platforms instead of 15 auth flows and 15 sets of breaking changes.
- [Demo](https://info.bundle.social/demo.md): Watch bundle.social in action. Demo videos of the web app and API covering scheduling, multi-platform publishing, and analytics with real examples.
- [FAQ](https://info.bundle.social/faq.md): Frequently asked questions about bundle.social. How to get started, connect accounts, schedule posts, what counts toward limits, and how billing works.
- [Changelog](https://info.bundle.social/changelog.md): Stay up to date with the latest changes to our app and API. New platform integrations, endpoints, analytics, and breaking changes, newest first.
- [Glossary](https://info.bundle.social/glossary.md): Glossary of terms used widely in social media marketing and APIs, from engagement rate and reach to webhooks, OAuth scopes, and rate limiting.
- [Introduction](https://info.bundle.social/api-reference/introduction.md): Get started with the bundle.social API. API key auth via x-api-key, the base URL, how organizations and teams fit together, and where rate limits bite.
- [Health](https://info.bundle.social/api-reference/health.md): Check API and platform health before sending users into broken flows. GET /api/v1 returns live per-platform status so you can disable what is down.
- [OpenAPI](https://info.bundle.social/api-reference/openapi.md): The full OpenAPI 3.0 spec for the bundle.social API. Try endpoints live, browse them in Swagger UI, or generate a typed client in your own language.
- [SDK](https://info.bundle.social/api-reference/sdk.md): Don't reinvent the wheel. Our typed TypeScript SDK for Node.js handles auth headers and the boring parts, and there is a CLI and MCP server too.
- [CLI](https://info.bundle.social/api-reference/cli.md): Post to 14+ social platforms from your shell, CI, cron or an AI agent.
- [MCP Server](https://info.bundle.social/api-reference/mcp.md): Drive bundle.social from Claude, Cursor and other Model Context Protocol clients.
- [Platform parameters](https://info.bundle.social/api-reference/platform-parameters.md): Every per-platform field you can put under data.<PLATFORM> when creating a post.
- [Connect Social Accounts](https://info.bundle.social/api-reference/connect-social-accounts.md): Learn how OAuth, hosted connect links, custom connect flows, and channel selection work in bundle.social.
- [Hosted Flow](https://info.bundle.social/api-reference/connect-social-accounts/hosted-flow.md): Create a hosted social account connect link and let bundle.social handle OAuth UI and channel selection.
- [Custom UI Flow](https://info.bundle.social/api-reference/connect-social-accounts/custom-ui-flow.md): Build your own social account connection flow using the connect endpoint, callbacks, and channel endpoints.
- [Channel Management](https://info.bundle.social/api-reference/connect-social-accounts/channel-management.md): Use set-channel, refresh-channels, and unset-channel for social accounts with selectable targets.
- [OAuth Options](https://info.bundle.social/api-reference/connect-social-accounts/oauth-options.md): Understand disableAutoLogin, tiktokForceLogin, forceBrowserOAuth, withBusinessScope, and Instagram connection methods.
- [Callback Parameters](https://info.bundle.social/api-reference/connect-social-accounts/callbacks.md): Handle success and error query parameters after social account OAuth completes.
- [Webhooks](https://info.bundle.social/api-reference/webhooks.md): We call you when things happen, so you don't have to poll. Real-time post and comment events with signature verification, retries, and auto-disable.
- [Examples](https://info.bundle.social/api-reference/examples.md): Working code, not pseudocode. Examples for schedulers, analytics dashboards, bulk uploaders, and webhook handlers, plus a GitHub repo and Postman collection.
- [Analytics](https://info.bundle.social/api-reference/analytics.md): How analytics work, how we refresh them, how long we keep them, and why some numbers are zero. The full picture.
- [Data Retention](https://info.bundle.social/api-reference/data-retention.md): What we keep, for how long, and when it disappears. Analytics 30 days, webhook events 7, deleted uploads 7, imported posts 30. Plan accordingly.
- [Platform Limits](https://info.bundle.social/api-reference/limits.md): Check these before you post. Every platform has rules. We enforce them so you don't get banned.
- [Rate Limits](https://info.bundle.social/api-reference/rate-limits.md): API limits, posting limits, commenting limits, and import quotas. No per-account charges: three layers of rate limiting plus daily caps per platform.
- [Import Post History](https://info.bundle.social/api-reference/import-posts.md): Pull past posts and analytics from Instagram, TikTok, LinkedIn and more. An async job backfills your dashboard with history from before you connected.
- [Bulk Post from CSV](https://info.bundle.social/api-reference/bulk-posts-csv.md): Create many posts at once by uploading a CSV file. Async processing with per-row results.
- [Media Upload](https://info.bundle.social/api-reference/upload-content.md): Upload images, videos, and documents with small or large upload flows.
- [Errors](https://info.bundle.social/api-reference/errors.md): When things go wrong (and they will). Standardized error codes across every platform, transient vs non-transient, and the prefixes that tell you who broke.
- [Comments](https://info.bundle.social/api-reference/comments.md): Import comments from published posts, show them in your app, and reply in the right thread.
- [Platforms Overview](https://info.bundle.social/api-reference/platforms/index.md): Everything you need to know about the platforms we support. The good, the bad, and the API limits.
- [Instagram](https://info.bundle.social/api-reference/platforms/instagram.md): Reels, Stories, Posts, and the strict laws of aspect ratios. Feed posts must sit between 4:5 and 1.91:1 or Instagram rejects them without mercy.
- [Instagram Music Library](https://info.bundle.social/api-reference/platforms/instagram-music.md): Search Instagram music and original sounds, then attach audio to Reels.
- [Facebook](https://info.bundle.social/api-reference/platforms/facebook.md): Pages, Reels, Stories, and the eternal struggle with token expiration.
- [Facebook Page Reviews](https://info.bundle.social/api-reference/platforms/facebook-page-reviews.md): Import, sync, and reply to Facebook Page reviews with an async job flow.
- [LinkedIn](https://info.bundle.social/api-reference/platforms/linkedin.md): The professional network. Where URNs are king and Personal profiles have limited superpowers.
- [TikTok](https://info.bundle.social/api-reference/platforms/tiktok.md): The viral machine. Watch out for music copyright, privacy settings, and image-format rules for photo mode.
- [TikTok Music (CML)](https://info.bundle.social/api-reference/platforms/tiktok-music.md): TikTok Commercial Music Library: pre-cleared tracks for videos and photos. Genres, date ranges, song_clip_id vs commercial_music_id, and the draft gotcha.
- [YouTube](https://info.bundle.social/api-reference/platforms/youtube.md): Long-form, Shorts, and the legal requirement of Made for Kids. Videos up to 4 hours and 5 GB, Shorts auto-detected, and a title is always required.
- [Snapchat](https://info.bundle.social/api-reference/platforms/snapchat.md): Connect Snapchat Public Profiles, publish Stories and Spotlights, and retrieve profile and content analytics.
- [Twitter / X](https://info.bundle.social/api-reference/platforms/twitter.md): It's X now. The API is... well, it exists. Analytics are not included.
- [Threads](https://info.bundle.social/api-reference/platforms/threads.md): Meta's text app. It's like Twitter, but with Meta's infrastructure and surprisingly decent API.
- [Pinterest](https://info.bundle.social/api-reference/platforms/pinterest.md): Pins, Boards, and a mixed bag of analytics periods. Every post needs a boardName, and saves matter more than likes on a discovery platform.
- [Reddit](https://info.bundle.social/api-reference/platforms/reddit.md): The front page of the internet. Minimalist analytics, maximum subreddit rules.
- [Mastodon](https://info.bundle.social/api-reference/platforms/mastodon.md): The decentralized social web. Basic metrics only, but at least it's open source.
- [Bluesky](https://info.bundle.social/api-reference/platforms/bluesky.md): The AT Protocol. Calculated impressions, limited data, but growing fast.
- [Discord](https://info.bundle.social/api-reference/platforms/discord.md): Channel-based messaging via webhooks, not OAuth. Requires a channelId on every post, and supports custom bot identity and media attachments.
- [Slack](https://info.bundle.social/api-reference/platforms/slack.md): Workspace messaging via incoming webhooks. Needs an admin to connect, a channel selection per post, and gives you a generous 30k character limit.
- [Google Business](https://info.bundle.social/api-reference/platforms/google-business.md): Local SEO posts, events, offers, and updates for your business profile.
- [Google Business Location & profile](https://info.bundle.social/api-reference/platforms/google-business-location.md): Read and update Business Profile location data: title, categories, address, phone, hours-related fields in one profile patch, and more.
- [Google Business Hours](https://info.bundle.social/api-reference/platforms/google-business-hours.md): Update regular, special, and more hours for a Google Business Profile location with explicit field selection.
- [Google Business Attributes](https://info.bundle.social/api-reference/platforms/google-business-attributes.md): Read location attributes, list attribute definitions for the category, and update structured facts on the profile.
- [Google Business Service list](https://info.bundle.social/api-reference/platforms/google-business-service-list.md): Read and update the structured list of services for eligible Google Business Profile locations.
- [Google Business Food menus](https://info.bundle.social/api-reference/platforms/google-business-food-menus.md): Read and update food menus for restaurant-class Google Business Profile locations.
- [Google Business Place action links](https://info.bundle.social/api-reference/platforms/google-business-place-action-links.md): List, create, update, and delete action links such as ordering, reservations, or appointments on the profile.
- [Google Business Profile media](https://info.bundle.social/api-reference/platforms/google-business-profile-media.md): List and delete photos or videos on the Google Business Profile, and add media via uploadId.
- [Google Business Reviews](https://info.bundle.social/api-reference/platforms/google-business-reviews.md): Import, sync, and reply to Google Business reviews with an async job flow.
- [Building a Scheduler](https://info.bundle.social/guides/building-scheduler.md): A practical guide to building a social media scheduling tool. The real one, not the 5-step tutorial.
- [Get health](https://info.bundle.social/api-reference/client/app/get-health.md): Check whether the bundle.social API is reachable and see the current operational status of every supported social platform. Use this endpoint for uptime monitoring and to detect platform-side outages before publishing.
- [Get organization](https://info.bundle.social/api-reference/client/organization/get-organization.md): Retrieve your organization's details, plan, and the teams it contains. Use this as the entry point for discovering the team IDs you need for other endpoints.
- [Get organization posts usage](https://info.bundle.social/api-reference/client/organization/get-organization-posts-usage.md): See how many posts your organization has consumed against its plan limit for the current billing period. Use it to monitor quota before scheduling large batches.
- [Get organization comments usage](https://info.bundle.social/api-reference/client/organization/get-organization-comments-usage.md): See how many comments your organization has consumed against its plan limit for the current billing period.
- [Get organization uploads usage](https://info.bundle.social/api-reference/client/organization/get-organization-uploads-usage.md): See how much upload capacity your organization has consumed against its plan limit for the current billing period.
- [Get daily limits usage for one social account on a given day](https://info.bundle.social/api-reference/client/organization/get-daily-limits-usage-for-one-social-account-on-a-given-day.md): Check how many posts a single social account has already published on a specific day versus the platform's own daily cap. Use this to avoid hitting platform-side publishing limits.
- [Get organization imports usage per social account (paginated)](https://info.bundle.social/api-reference/client/organization/get-organization-imports-usage-per-social-account-paginated.md): See how much import capacity each social account has consumed, paginated and filterable by team or platform. Use it to track post history and review import quota.
- [Get team](https://info.bundle.social/api-reference/client/team/get-team.md): Retrieve a single team with its connected social accounts and settings. Teams are the container that social accounts, posts, and uploads belong to.
- [Delete team](https://info.bundle.social/api-reference/client/team/delete-team.md): Permanently delete a team along with its connected social accounts, posts, and uploads. This cannot be undone.
- [Update team](https://info.bundle.social/api-reference/client/team/update-team.md): Update a team's name, avatar, time zone, or other settings. Only the fields you send are changed.
- [Get list of teams](https://info.bundle.social/api-reference/client/team/get-list-of-teams.md): List the teams in your organization with pagination. Use this to discover team IDs, which are required by most publishing and analytics endpoints.
- [Create new team](https://info.bundle.social/api-reference/client/team/create-new-team.md): Create a new team in your organization. Create one team per brand, client, or workspace you want to keep separate, then connect social accounts to it.
- [Connect social account for team](https://info.bundle.social/api-reference/client/socialaccount/connect-social-account-for-team.md): Generate OAuth URL for social account connection. Redirect user to this URL to connect social account. For Mastodon and Bluesky an unusable `serverUrl` returns 400 with the reason, while a reachable-but-failing instance returns 502.
- [Disconnect social account from team](https://info.bundle.social/api-reference/client/socialaccount/disconnect-social-account-from-team.md): This will remove the social account from all the scheduled posts too.
- [Set channel for social account](https://info.bundle.social/api-reference/client/socialaccount/set-channel-for-social-account.md): Needed only for some social account types - Youtube, Instagram, Facebook and Linkedin.
- [Unset channel for social account](https://info.bundle.social/api-reference/client/socialaccount/unset-channel-for-social-account.md): Clear selected channel while keeping social account authorization.
- [Refresh channels for social account](https://info.bundle.social/api-reference/client/socialaccount/refresh-channels-for-social-account.md): Refresh channels saved on socialAccount.channels. This is only needed for some social account types - Reddit, Discord, Slack, Pinterest.
- [Create portal link](https://info.bundle.social/api-reference/client/socialaccount/create-portal-link.md): Simplify connect flow. Create a portal link which can be used to manage connected social accounts directly on bundle.social platform without implementing the logic on your side.
- [Manually run connection/disconnect check](https://info.bundle.social/api-reference/client/socialaccount/manually-run-connectiondisconnect-check.md): Force an immediate check of whether a social account's authorization is still valid, instead of waiting for the scheduled check. Use it to surface expired tokens before a scheduled post fails.
- [Manually refresh social account profile info](https://info.bundle.social/api-reference/client/socialaccount/manually-refresh-social-account-profile-info.md): Pull the latest profile name, handle, and avatar from the platform for a connected account. Use it to keep your own UI in sync after a user renames their profile.
- [Get social account by team and type](https://info.bundle.social/api-reference/client/socialaccount/get-social-account-by-team-and-type.md): Look up a team's connected account for a specific platform without listing every account first. Useful when you already know which platform you want to publish to.
- [Copy social accounts](https://info.bundle.social/api-reference/client/socialaccount/copy-social-accounts.md): Copy connected social accounts from one team to another so you can reuse an existing authorization without sending the user through OAuth again.
- [Get paginated social accounts scheduled to delete](https://info.bundle.social/api-reference/client/socialaccount/get-paginated-social-accounts-scheduled-to-delete.md): List social accounts queued for deletion, with pagination. Use it to warn users before an account and its data are permanently removed.
- [Get upload list](https://info.bundle.social/api-reference/client/upload/get-upload-list.md): List the media files in your team's library, filterable and including the posts each file is used in. Use it to reuse existing media instead of uploading duplicates.
- [Create upload](https://info.bundle.social/api-reference/client/upload/create-upload.md): Upload a file. This is the only endpoint that uses multipart/form-data.
- [Delete many uploads](https://info.bundle.social/api-reference/client/upload/delete-many-uploads.md): Permanently delete several media files in one request. Use it to clean up your library in bulk instead of calling delete per file.
- [Get upload](https://info.bundle.social/api-reference/client/upload/get-upload.md): Retrieve a single media file with its processing status, dimensions, duration, and the posts it is attached to.
- [Delete upload](https://info.bundle.social/api-reference/client/upload/delete-upload.md): Permanently delete a single media file from your library. Files still attached to scheduled posts should be replaced first.
- [Create upload from URL](https://info.bundle.social/api-reference/client/upload/create-upload-from-url.md): Add an image or video to your media library by giving bundle.social a public URL to fetch, instead of uploading the bytes yourself. Useful when your media already lives in a CDN or S3 bucket.
- [Initialize large upload](https://info.bundle.social/api-reference/client/upload/initialize-large-upload.md): Initialize large upload, you need to initialize a large upload if your file is larger than 90 MB.
- [Finalize large upload](https://info.bundle.social/api-reference/client/upload/finalize-large-upload.md): Finalize large upload.
- [Initialize multipart upload](https://info.bundle.social/api-reference/client/upload/initialize-multipart-upload.md): Start a multipart upload. Required above the 5 GiB single-request storage limit that /upload/init is bound by, and allowed for any smaller file too. Returns an uploadId plus one presigned URL per part; PUT each part, keep the ETag response header, then call complete with the full part list. Parts ar…
- [Re-sign multipart upload parts](https://info.bundle.social/api-reference/client/upload/re-sign-multipart-upload-parts.md): Issue fresh presigned URLs for parts whose original URLs expired mid-upload. Parts already uploaded keep their ETags — only re-upload the ones that failed.
- [Complete multipart upload](https://info.bundle.social/api-reference/client/upload/complete-multipart-upload.md): Assemble the uploaded parts into the final object and add it to your media library. Send every part with the ETag returned by its PUT. A 500 is always retryable — whatever we have (your parts, or the assembled object) is kept, so retry this call rather than re-uploading. A 400 is final: either the p…
- [Abort multipart upload](https://info.bundle.social/api-reference/client/upload/abort-multipart-upload.md): Discard an unfinished multipart upload and its parts. Call this when you give up on an upload — abandoned parts stay in storage and count against your usage.
- [Get posts that can be reconnected to a social account](https://info.bundle.social/api-reference/client/post/get-posts-that-can-be-reconnected-to-a-social-account.md): List posts that lost their link to a social account after a disconnect, and that can be reattached to a newly connected account of the same platform.
- [Reconnect social account to matching posts](https://info.bundle.social/api-reference/client/post/reconnect-social-account-to-matching-posts.md): Reattach a newly connected social account to posts that were orphaned when the previous account was disconnected, so scheduled posts publish instead of failing.
- [Get post by reference key](https://info.bundle.social/api-reference/client/post/get-post-by-reference-key.md): Retrieve a single post using your own reference key instead of the bundle.social post ID. Useful when you store your own identifier on create and want to look the post up later without keeping a mapping table.
- [Get post](https://info.bundle.social/api-reference/client/post/get-post.md): Retrieve a single post by ID, including its per-platform status, scheduled time, media, and any publishing errors.
- [Delete post](https://info.bundle.social/api-reference/client/post/delete-post.md): Permanently delete a post from bundle.social. Deleting a scheduled post cancels it; deleting an already-published post does not remove it from the social platform.
- [Update post](https://info.bundle.social/api-reference/client/post/update-post.md): Change the content, media, scheduled time, or target platforms of a post that has not published yet. Only the fields you send are modified.
- [Get post list](https://info.bundle.social/api-reference/client/post/get-post-list.md): List and filter posts across a team by status, platform, or date range with pagination. Use this to build a content calendar or reconcile your own database with bundle.social.
- [Create post](https://info.bundle.social/api-reference/client/post/create-post.md): Schedule or immediately publish a post to one or more connected social accounts in a single request. Supply shared content plus optional per-platform overrides for captions, media, and platform-specific options.
- [Retry post](https://info.bundle.social/api-reference/client/post/retry-post.md): Re-attempt publishing a post that failed, for example after a token expired or a platform outage. Fix the underlying cause first, then retry.
- [Get Social Account Analytics](https://info.bundle.social/api-reference/client/analytics/get-social-account-analytics.md): Retrieve normalized profile-level metrics such as followers, reach, and impressions for a connected social account over a date range. Metric names are unified across platforms so you can chart accounts side by side.
- [Get Post Analytics](https://info.bundle.social/api-reference/client/analytics/get-post-analytics.md): Retrieve normalized engagement metrics such as likes, comments, shares, and views for a single published post. Metric names are unified across platforms for easier reporting.
- [Get Social Account Analytics Raw](https://info.bundle.social/api-reference/client/analytics/get-social-account-analytics-raw.md): Retrieve profile-level analytics exactly as returned by the social platform, without bundle.social's normalization. Use this when you need a platform-specific metric that the normalized response does not expose.
- [Get Post Analytics Raw](https://info.bundle.social/api-reference/client/analytics/get-post-analytics-raw.md): Retrieve post analytics exactly as returned by the social platform, without bundle.social's normalization. Use this when you need a platform-specific metric that the normalized response does not expose.
- [Get Bulk Post Analytics](https://info.bundle.social/api-reference/client/analytics/get-bulk-post-analytics.md): Retrieve analytics for multiple posts in a single request. Maximum 60 posts per request, paginated with 20 per page.
- [Force refresh social account analytics](https://info.bundle.social/api-reference/client/analytics/force-refresh-social-account-analytics.md): Trigger an immediate fetch of fresh profile analytics from the platform instead of waiting for the scheduled refresh. Use sparingly, as it consumes platform rate limits.
- [Force refresh post analytics](https://info.bundle.social/api-reference/client/analytics/force-refresh-post-analytics.md): Trigger an immediate fetch of fresh analytics for a single post instead of waiting for the scheduled refresh. Use sparingly, as it consumes platform rate limits.
- [Get comment import list](https://info.bundle.social/api-reference/client/comment/get-comment-import-list.md): List comment import jobs for a team so you can monitor which imports are queued, running, finished, or failed.
- [Start a new comment import for a post](https://info.bundle.social/api-reference/client/comment/start-a-new-comment-import-for-a-post.md): Kick off an asynchronous import that pulls existing comments from a published post on the social platform into bundle.social so you can read and reply to them through the API.
- [Get fetched comments for a post](https://info.bundle.social/api-reference/client/comment/get-fetched-comments-for-a-post.md): List the comments pulled in by a comment import, with pagination. Use this to read audience replies and decide which ones need a response.
- [Run an action on a fetched comment](https://info.bundle.social/api-reference/client/comment/run-an-action-on-a-fetched-comment.md): Reply to, hide, like, or delete an imported comment directly on the social platform. Use this to moderate and engage without leaving your own app.
- [Get comment import by ID](https://info.bundle.social/api-reference/client/comment/get-comment-import-by-id.md): Check the status, progress, and result of a single comment import job.
- [Get comment](https://info.bundle.social/api-reference/client/comment/get-comment.md): Retrieve a single comment you created through bundle.social, including its publishing status and any error details.
- [Delete comment](https://info.bundle.social/api-reference/client/comment/delete-comment.md): Permanently delete a comment from bundle.social. Deleting a scheduled comment cancels it before it publishes.
- [Update comment](https://info.bundle.social/api-reference/client/comment/update-comment.md): Change the content or scheduled time of a comment that has not published yet.
- [Get comment list](https://info.bundle.social/api-reference/client/comment/get-comment-list.md): List and filter the comments your organization has created, with pagination. Use it to track which scheduled comments published successfully.
- [Create comment](https://info.bundle.social/api-reference/client/comment/create-comment.md): Publish a comment or a reply on one of your published posts. Use it to schedule the first comment on Instagram or LinkedIn, or to respond to your audience programmatically.
- [Retry comment](https://info.bundle.social/api-reference/client/comment/retry-comment.md): Re-attempt publishing a comment that failed, for example after a token expired or a platform outage.
- [Set or change thumbnail for a YouTube video](https://info.bundle.social/api-reference/client/misc/set-or-change-thumbnail-for-a-youtube-video.md): Upload a custom thumbnail for a published YouTube video. Custom thumbnails require a verified channel and strongly influence click-through rate.
- [Get channel playlists](https://info.bundle.social/api-reference/client/misc/get-channel-playlists.md): List the playlists on a connected YouTube channel, with their IDs, titles, and privacy status.
- [Update an existing playlist](https://info.bundle.social/api-reference/client/misc/update-an-existing-playlist.md): Change the title, description, or privacy status of a YouTube playlist on a connected channel. Send the playlist ID together with the fields you want to update.
- [Create a new playlist](https://info.bundle.social/api-reference/client/misc/create-a-new-playlist.md): Create a playlist on a connected YouTube channel with a title, description, and privacy status. Playlists group related videos and increase session watch time.
- [Delete a channel playlist](https://info.bundle.social/api-reference/client/misc/delete-a-channel-playlist.md): Permanently delete a playlist from a connected YouTube channel. The videos themselves are not deleted.
- [Get videos from a playlist](https://info.bundle.social/api-reference/client/misc/get-videos-from-a-playlist.md): List the videos in a YouTube playlist, including the playlist item IDs required to remove individual entries.
- [Add a video to a playlist](https://info.bundle.social/api-reference/client/misc/add-a-video-to-a-playlist.md): Append a video to a YouTube playlist on a connected channel.
- [Remove a video from a playlist](https://info.bundle.social/api-reference/client/misc/remove-a-video-from-a-playlist.md): Remove a single video from a YouTube playlist. Pass the playlist item ID, not the video ID. The video itself stays on the channel.
- [Delete a YouTube video](https://info.bundle.social/api-reference/client/misc/delete-a-youtube-video.md): Permanently delete a published YouTube video.
- [Edit YouTube video metadata](https://info.bundle.social/api-reference/client/misc/edit-youtube-video-metadata.md): Update the title, description, tags, category, or privacy status of a published YouTube video.
- [Delete a YouTube comment](https://info.bundle.social/api-reference/client/misc/delete-a-youtube-comment.md): Permanently delete a published YouTube comment.
- [Edit YouTube comment](https://info.bundle.social/api-reference/client/misc/edit-youtube-comment.md): Update the text content of a published YouTube comment.
- [Get YouTube video categories](https://info.bundle.social/api-reference/client/misc/get-youtube-video-categories.md): Retrieve the list of video categories that can be associated with YouTube videos for a specific region.
- [Get YouTube regions](https://info.bundle.social/api-reference/client/misc/get-youtube-regions.md): Retrieve the list of content regions that the YouTube website supports.
- [Get Linkedin mentionable tags (people & organizations)](https://info.bundle.social/api-reference/client/misc/get-linkedin-mentionable-tags-people-&-organizations.md): Search for LinkedIn people and organizations that can be @-mentioned, and get the tag IDs needed to insert them into post text. LinkedIn only renders a mention when the display text matches the entity's name exactly (case sensitive), so a vanity slug never works. When a person is resolved from `url`…
- [Build Linkedin text, insert mentions at tag placeholders.](https://info.bundle.social/api-reference/client/misc/build-linkedin-text-insert-mentions-at-tag-placeholders.md): If tag already exists (case insensitive), mentions replace it; otherwise they're appended to the end.
- [Reshare an existing LinkedIn post](https://info.bundle.social/api-reference/client/misc/reshare-an-existing-linkedin-post.md): Create a LinkedIn reshare as the currently selected LinkedIn channel.
- [Delete a LinkedIn post](https://info.bundle.social/api-reference/client/misc/delete-a-linkedin-post.md): Permanently delete a published LinkedIn post.
- [Edit an existing LinkedIn post](https://info.bundle.social/api-reference/client/misc/edit-an-existing-linkedin-post.md): Update the text content of a published LinkedIn post.
- [Delete a LinkedIn comment](https://info.bundle.social/api-reference/client/misc/delete-a-linkedin-comment.md): Permanently delete a published LinkedIn comment.
- [Edit an existing LinkedIn comment](https://info.bundle.social/api-reference/client/misc/edit-an-existing-linkedin-comment.md): Update the text content of a published LinkedIn comment.
- [List Google Business media items](https://info.bundle.social/api-reference/client/misc/list-google-business-media-items.md): List the photos and videos on your Google Business Profile, with paging. Use it to audit which images are live before adding or removing media.
- [Add a media item (photo/video) using uploadId and category](https://info.bundle.social/api-reference/client/misc/add-a-media-item-photovideo-using-uploadid-and-category.md): Publish a photo or video to your Google Business Profile from a bundle.social upload, tagged with a category such as exterior, interior, or product. Fresh photos are a local ranking and conversion signal.
- [Delete Google Business media item](https://info.bundle.social/api-reference/client/misc/delete-google-business-media-item.md): Remove a photo or video from your Google Business Profile.
- [Delete a Google Business post](https://info.bundle.social/api-reference/client/misc/delete-a-google-business-post.md): Permanently delete a published Google Business post.
- [Get Google Business location profile](https://info.bundle.social/api-reference/client/misc/get-google-business-location-profile.md): Use typed query param `fields`. Supports both comma-separated values (`fields=name,title`) and repeated params (`fields=name&fields=title`).
- [Update Google Business location profile fields](https://info.bundle.social/api-reference/client/misc/update-google-business-location-profile-fields.md): Field mask is derived automatically from provided fields.
- [Update Google Business regular/special/more hours](https://info.bundle.social/api-reference/client/misc/update-google-business-regularspecialmore-hours.md): Body requires `fields` (`regularHours`, `specialHours`, `moreHours`).
- [Get Google Business location attributes](https://info.bundle.social/api-reference/client/misc/get-google-business-location-attributes.md): Retrieve the attributes currently set on your Google Business Profile location, such as accessibility, payment options, or amenities.
- [Update Google Business location attributes](https://info.bundle.social/api-reference/client/misc/update-google-business-location-attributes.md): Set or change attributes on your Google Business Profile location. Complete attributes help your listing surface for more specific local searches.
- [List available Google Business attributes](https://info.bundle.social/api-reference/client/misc/list-available-google-business-attributes.md): List the attributes Google allows for your location's category and country. Check this before updating attributes, since the valid set differs per business category.
- [List available Google Business categories](https://info.bundle.social/api-reference/client/misc/list-available-google-business-categories.md): Requires `regionCode` and `languageCode`. Default `view=BASIC`. Optional `names` fetches exact category IDs through `categories:batchGet`; otherwise `filter` supports `displayName` prefix search.
- [Get Google Business service list](https://info.bundle.social/api-reference/client/misc/get-google-business-service-list.md): Retrieve the services listed on your Google Business Profile, including custom services and prices.
- [Update Google Business service list](https://info.bundle.social/api-reference/client/misc/update-google-business-service-list.md): Body requires `fields` (`serviceItems`).
- [Get Google Business food menus](https://info.bundle.social/api-reference/client/misc/get-google-business-food-menus.md): Use typed query param `fields`. Supports both comma-separated values (`fields=name,menus`) and repeated params (`fields=name&fields=menus`).
- [Update Google Business food menus](https://info.bundle.social/api-reference/client/misc/update-google-business-food-menus.md): Body requires `fields` (`menus`).
- [List Google Business place action links](https://info.bundle.social/api-reference/client/misc/list-google-business-place-action-links.md): List the action links on your Google Business Profile, such as booking, ordering, or reservation URLs.
- [Create Google Business place action link](https://info.bundle.social/api-reference/client/misc/create-google-business-place-action-link.md): Add an action link such as Book, Order online, or Reserve to your Google Business Profile so customers can convert straight from the listing.
- [Delete Google Business place action link](https://info.bundle.social/api-reference/client/misc/delete-google-business-place-action-link.md): Remove an action link from your Google Business Profile, for example when a booking URL is retired.
- [Update Google Business place action link](https://info.bundle.social/api-reference/client/misc/update-google-business-place-action-link.md): Body requires `fields` (`uri`, `placeActionType`, `isPreferred`).
- [Get review import status list](https://info.bundle.social/api-reference/client/misc/get-review-import-status-list.md): List Google Review import jobs for a team so you can monitor which imports are queued, running, finished, or failed.
- [Start a new Google Reviews import](https://info.bundle.social/api-reference/client/misc/start-a-new-google-reviews-import.md): Kick off an asynchronous import that pulls your Google Business Profile reviews into bundle.social so you can read and reply to them through the API.
- [Get review import by ID](https://info.bundle.social/api-reference/client/misc/get-review-import-by-id.md): Check the status, progress, and result of a single Google Reviews import job.
- [List imported Google Reviews](https://info.bundle.social/api-reference/client/misc/list-imported-google-reviews.md): List the Google Reviews pulled in by an import, with paging and your remaining import capacity. Use it to build a review inbox or monitor rating trends.
- [Get a single imported Google Review](https://info.bundle.social/api-reference/client/misc/get-a-single-imported-google-review.md): Retrieve one imported Google Review with its star rating, text, reviewer, and any existing owner reply.
- [Reply to a Google Review (creates or updates the owner reply)](https://info.bundle.social/api-reference/client/misc/reply-to-a-google-review-creates-or-updates-the-owner-reply.md): Publish or update the owner reply on a Google Review. Google allows one owner reply per review, so sending again overwrites the previous text.
- [Delete the owner reply from a Google Review](https://info.bundle.social/api-reference/client/misc/delete-the-owner-reply-from-a-google-review.md): Remove your owner reply from a Google Review, leaving the customer's review in place.
- [Get subreddit post requirements (flair required/enabled)](https://info.bundle.social/api-reference/client/misc/get-subreddit-post-requirements-flair-requiredenabled.md): Check a subreddit's posting rules before publishing, including whether flair is enabled or mandatory. Call this first to avoid rejected submissions.
- [Get subreddit flairs list](https://info.bundle.social/api-reference/client/misc/get-subreddit-flairs-list.md): List the flairs available in a subreddit so you can attach a valid flair ID when creating a Reddit post.
- [Delete a Reddit post](https://info.bundle.social/api-reference/client/misc/delete-a-reddit-post.md): Permanently delete a published Reddit post.
- [Edit an existing Reddit post](https://info.bundle.social/api-reference/client/misc/edit-an-existing-reddit-post.md): Update the selftext content of a published Reddit text post. Link and media posts cannot be edited.
- [Delete a Reddit comment](https://info.bundle.social/api-reference/client/misc/delete-a-reddit-comment.md): Permanently delete a published Reddit comment.
- [Edit an existing Reddit comment](https://info.bundle.social/api-reference/client/misc/edit-an-existing-reddit-comment.md): Update the text content of a published Reddit comment.
- [Search for Instagram Business/Creator user by username](https://info.bundle.social/api-reference/client/misc/search-for-instagram-businesscreator-user-by-username.md): Checks if an Instagram user exists and returns their public profile data. Only works for Business and Creator accounts and only when Instagram is connected via Facebook Login. Returns followers_count, media_count, and profile picture if available.
- [Search Instagram location IDs](https://info.bundle.social/api-reference/client/misc/search-instagram-location-ids.md): Searches Facebook Pages with physical location data and returns IDs that can be used as data.INSTAGRAM.locationId.
- [Search Instagram audio assets](https://info.bundle.social/api-reference/client/misc/search-instagram-audio-assets.md): Searches Instagram music or original sounds that can be attached to Reels. Only works for Instagram accounts connected via Facebook Login.
- [Delete an Instagram comment](https://info.bundle.social/api-reference/client/misc/delete-an-instagram-comment.md): Permanently delete a published Instagram comment.
- [Get Facebook token debug details](https://info.bundle.social/api-reference/client/misc/get-facebook-token-debug-details.md): Inspect a connected Facebook account's access token, including its scopes and expiry. Use it to diagnose permission errors when publishing fails.
- [Get Facebook recommendations import status list](https://info.bundle.social/api-reference/client/misc/get-facebook-recommendations-import-status-list.md): List Facebook recommendation import jobs for a team so you can monitor which imports are queued, running, finished, or failed.
- [Start a new Facebook recommendations import](https://info.bundle.social/api-reference/client/misc/start-a-new-facebook-recommendations-import.md): Kick off an asynchronous import that pulls recommendations left on your Facebook Page into bundle.social so you can read and reply to them through the API.
- [Get Facebook recommendations import by ID](https://info.bundle.social/api-reference/client/misc/get-facebook-recommendations-import-by-id.md): Check the status, progress, and result of a single Facebook recommendations import job.
- [List imported Facebook recommendations](https://info.bundle.social/api-reference/client/misc/list-imported-facebook-recommendations.md): List the Facebook Page recommendations pulled in by an import, with paging and your remaining import capacity. Use it to build a reputation-management inbox.
- [Get a single imported Facebook recommendation](https://info.bundle.social/api-reference/client/misc/get-a-single-imported-facebook-recommendation.md): Retrieve one imported Facebook recommendation with its rating, text, author, and existing replies.
- [Get recommendation thread comments](https://info.bundle.social/api-reference/client/misc/get-recommendation-thread-comments.md): List the comments in a Facebook recommendation thread so you can see the full conversation before replying.
- [Reply to a Facebook recommendation](https://info.bundle.social/api-reference/client/misc/reply-to-a-facebook-recommendation.md): Publish a Page reply to a Facebook recommendation. Use it to respond to reviews programmatically instead of through Meta Business Suite.
- [Reply to a Facebook recommendation thread comment](https://info.bundle.social/api-reference/client/misc/reply-to-a-facebook-recommendation-thread-comment.md): Publish a reply to a specific comment inside a Facebook recommendation thread.
- [Delete a Facebook post](https://info.bundle.social/api-reference/client/misc/delete-a-facebook-post.md): Permanently delete a published Facebook post or reel.
- [Edit an existing Facebook post](https://info.bundle.social/api-reference/client/misc/edit-an-existing-facebook-post.md): Update the message/content of a published Facebook post or reel. Note: Only text content can be edited, media cannot be changed.
- [Delete a Facebook comment](https://info.bundle.social/api-reference/client/misc/delete-a-facebook-comment.md): Permanently delete a published Facebook comment.
- [Edit a Facebook comment](https://info.bundle.social/api-reference/client/misc/edit-a-facebook-comment.md): Update the text content of a published Facebook comment.
- [Delete a Pinterest pin](https://info.bundle.social/api-reference/client/misc/delete-a-pinterest-pin.md): Permanently delete a published Pinterest pin.
- [[DISABLED] Edit an existing Pinterest pin](https://info.bundle.social/api-reference/client/misc/[disabled]-edit-an-existing-pinterest-pin.md): Temporarily disabled
- [Delete a Mastodon status](https://info.bundle.social/api-reference/client/misc/delete-a-mastodon-status.md): Permanently delete a published Mastodon status.
- [Edit an existing Mastodon status](https://info.bundle.social/api-reference/client/misc/edit-an-existing-mastodon-status.md): Update the text content and spoiler text of a published Mastodon status.
- [Delete a Mastodon comment](https://info.bundle.social/api-reference/client/misc/delete-a-mastodon-comment.md): Permanently delete a published Mastodon reply/comment.
- [Edit a Mastodon comment](https://info.bundle.social/api-reference/client/misc/edit-a-mastodon-comment.md): Update the text content of a published Mastodon reply/comment.
- [Delete a Slack message](https://info.bundle.social/api-reference/client/misc/delete-a-slack-message.md): Permanently delete a published Slack message.
- [Edit an existing Slack message](https://info.bundle.social/api-reference/client/misc/edit-an-existing-slack-message.md): Update the text content of a published Slack message.
- [Delete a Bluesky post](https://info.bundle.social/api-reference/client/misc/delete-a-bluesky-post.md): Permanently delete a published Bluesky post.
- [Delete a Bluesky comment](https://info.bundle.social/api-reference/client/misc/delete-a-bluesky-comment.md): Permanently delete a published Bluesky reply/comment.
- [Delete a Twitter/X tweet](https://info.bundle.social/api-reference/client/misc/delete-a-twitterx-tweet.md): Permanently delete a published Twitter/X tweet.
- [Delete a Discord message](https://info.bundle.social/api-reference/client/misc/delete-a-discord-message.md): Permanently delete a published Discord message.
- [Get popular tracks from TikTok Commercial Music Library](https://info.bundle.social/api-reference/client/misc/get-popular-tracks-from-tiktok-commercial-music-library.md): Retrieve up to 100 popular tracks pre-cleared for organic content and ad creation from TikTok CML.
- [Delete a TikTok comment](https://info.bundle.social/api-reference/client/misc/delete-a-tiktok-comment.md): Delete a published TikTok comment.
- [Get import status list](https://info.bundle.social/api-reference/client/postimport/get-import-status-list.md): List post history import jobs for a team so you can monitor which backfills are queued, running, finished, or failed.
- [Start a new post history import](https://info.bundle.social/api-reference/client/postimport/start-a-new-post-history-import.md): Kick off an asynchronous import that backfills posts a social account published before it was connected to bundle.social, together with their analytics. Use it to get historical reporting from day one.
- [Get import by ID](https://info.bundle.social/api-reference/client/postimport/get-import-by-id.md): Check the status, progress, and result of a single post history import job.
- [Get imported posts with analytics for a social account](https://info.bundle.social/api-reference/client/postimport/get-imported-posts-with-analytics-for-a-social-account.md): List the historical posts pulled in by an import, with their analytics and your remaining import capacity. Use it to report on performance from before the account was connected.
- [Bulk delete imported posts and their analytics](https://info.bundle.social/api-reference/client/postimport/bulk-delete-imported-posts-and-their-analytics.md): Permanently delete up to 100 imported historical posts and their analytics in one request, freeing import capacity.
- [Retry a failed import](https://info.bundle.social/api-reference/client/postimport/retry-a-failed-import.md): Re-run a post history import that failed, for example after a token expired or the platform rate-limited the request.
- [Get post CSV import history](https://info.bundle.social/api-reference/client/postcsv/get-post-csv-import-history.md): List your team's bulk CSV post imports with pagination, so you can see what was uploaded and when.
- [Create post CSV import](https://info.bundle.social/api-reference/client/postcsv/create-post-csv-import.md): Upload CSV for async bulk post import.
- [Get post CSV import details](https://info.bundle.social/api-reference/client/postcsv/get-post-csv-import-details.md): Retrieve a single CSV import with its summary counts and configuration.
- [Get post CSV import processing status](https://info.bundle.social/api-reference/client/postcsv/get-post-csv-import-processing-status.md): Poll the progress of a bulk CSV post import, including how many rows are processed, succeeded, and failed.
- [Get post CSV import row results](https://info.bundle.social/api-reference/client/postcsv/get-post-csv-import-row-results.md): List the per-row outcome of a CSV import with pagination, showing which rows created posts and which failed validation and why. Use it to report errors back to the person who uploaded the file.
- [Knowledge Base](https://info.bundle.social/knowledge/index.md): This is a knowledge base for bundle.social. You can find all the information you need here.
- [Get to know organizations in bundle.social](https://info.bundle.social/knowledge/organization/what-is-an-organization.md): Learn how organizations work in bundle.social - manage billing, API keys, and webhooks at the organization level across all of your teams.
- [Get to know teams in bundle.social](https://info.bundle.social/knowledge/teams/what-are-teams.md): How teams work in bundle.social: create them, switch between them, manage settings. A team is a social set grouping accounts for one brand or client.
- [Make your first posts with bundle.social](https://info.bundle.social/knowledge/posts/create-first-post.md): Create and schedule your first post across several platforms at once, with per-platform customization and the Discord and Slack quirk explained.
- [What is the Media Library?](https://info.bundle.social/knowledge/posts/media-library.md): Learn how to use the Media Library in bundle.social to store, organize, and manage your social media content. Upload, filter, and track used vs unused media.
- [Discord and Slack bots on bundle.social](https://info.bundle.social/knowledge/posts/dc-slack-bots.md): Learn how to create and manage Discord and Slack bots for posting content through bundle.social. Understand why bots are required and how to set them up.
- [Social Accounts](https://info.bundle.social/knowledge/social-accounts/index.md): Tutorials for connecting every supported platform to bundle.social. Each one ends with an error section, so you can fix issues as they come up.
- [Connect your TikTok account to bundle.social](https://info.bundle.social/knowledge/social-accounts/tiktok.md): Learn how to connect your TikTok account to bundle.social. Follow our step-by-step guide to authorize permissions and start scheduling TikTok videos.
- [Connect your Youtube channel to bundle.social](https://info.bundle.social/knowledge/social-accounts/youtube.md): Complete guide to connecting your YouTube channel to bundle.social. Learn how to authorize permissions and start scheduling YouTube videos.
- [Connect your Snapchat account to bundle.social](https://info.bundle.social/knowledge/social-accounts/snapchat.md): Connect a Snapchat Public Profile to bundle.social for Stories, Spotlights, and analytics.
- [Connect your Instagram account to bundle.social](https://info.bundle.social/knowledge/social-accounts/instagram.md): Learn how to connect your Instagram account to bundle.social. Follow our step-by-step guide to authorize permissions and start scheduling Instagram posts.
- [Connect your Facebook account to bundle.social](https://info.bundle.social/knowledge/social-accounts/facebook.md): Complete tutorial on connecting your Facebook page to bundle.social. Learn how to authorize permissions and start scheduling Facebook posts.
- [Connect your X (Twitter) account to bundle.social](https://info.bundle.social/knowledge/social-accounts/x.md): Step-by-step tutorial on connecting your X (Twitter) account to bundle.social. Learn how to authorize permissions and start scheduling tweets.
- [Connect your Linkedin account to bundle.social](https://info.bundle.social/knowledge/social-accounts/linkedin.md): Tutorial on connecting your LinkedIn account or page to bundle.social. Learn how to authorize permissions and start scheduling LinkedIn posts.
- [Connect your Pinterest account to bundle.social](https://info.bundle.social/knowledge/social-accounts/pinterest.md): Learn how to connect your Pinterest account to bundle.social. Follow our guide to authorize permissions and start scheduling Pinterest pins.
- [Connect your Reddit account to bundle.social](https://info.bundle.social/knowledge/social-accounts/reddit.md): Step-by-step guide to connecting your Reddit account to bundle.social. Learn how to authorize permissions and start scheduling Reddit posts.
- [Connect your Threads account to bundle.social](https://info.bundle.social/knowledge/social-accounts/threads.md): Learn how to connect Threads to bundle.social and start publishing text and media posts.
- [Connect your Mastodon account to bundle.social](https://info.bundle.social/knowledge/social-accounts/mastodon.md): Learn how to connect a Mastodon account from your instance to bundle.social.
- [Connect your Bluesky account to bundle.social](https://info.bundle.social/knowledge/social-accounts/bluesky.md): Learn how to connect Bluesky to bundle.social using AT Protocol OAuth.
- [Connect your Discord account to bundle.social](https://info.bundle.social/knowledge/social-accounts/discord.md): Step-by-step guide to connecting your Discord account to bundle.social. Learn how to authorize permissions and set up Discord bots for automated posting.
- [Connect your Slack account to bundle.social](https://info.bundle.social/knowledge/social-accounts/slack.md): Complete guide to connecting your Slack workspace to bundle.social. Learn how to authorize permissions and set up Slack bots for automated posting.
- [Connect your Google Business Profile to bundle.social](https://info.bundle.social/knowledge/social-accounts/google-business.md): Learn how to connect Google Business Profile to bundle.social and select the business location for your team.
- [Comparison](https://info.bundle.social/comparison/index.md): See how bundle.social compares to other social media management tools. Honest breakdowns with real pricing data for developers, SaaS builders, and agencies.
- [bundle.social vs Sprout Social](https://info.bundle.social/comparison/sproutsocial.md): bundle.social vs Sprout Social: pricing, features, API access, and who each is built for. An honest breakdown for developers and SaaS builders.
- [bundle.social vs Hootsuite](https://info.bundle.social/comparison/hootsuite.md): Comparing bundle.social with Hootsuite - pricing, features, API access, and who each platform is built for. Honest breakdown for developers and SaaS builders.
- [bundle.social vs Zoho Social](https://info.bundle.social/comparison/zohosocial.md): Comparing bundle.social with Zoho Social - pricing, features, API access, and who each platform is built for. Honest breakdown for developers and SaaS builders.
- [bundle.social vs Buffer](https://info.bundle.social/comparison/buffer.md): Comparing bundle.social with Buffer - pricing, features, API access, and who each platform is built for. Honest breakdown for developers and SaaS builders.
- [bundle.social vs Later](https://info.bundle.social/comparison/later.md): Comparing bundle.social with Later - pricing, features, API access, and who each platform is built for. Honest breakdown for developers and SaaS builders.
- [bundle.social vs Publer](https://info.bundle.social/comparison/publer.md): Comparing bundle.social with Publer - pricing, features, API access, and who each platform is built for. Honest breakdown for developers and SaaS builders.
- [bundle.social vs Ayrshare](https://info.bundle.social/comparison/ayrshare.md): bundle.social vs Ayrshare: pricing, features, API access, and who each is built for. The most direct comparison, since both are API-first.
- [bundle.social vs SocialPilot](https://info.bundle.social/comparison/socialpilot.md): Comparing bundle.social with SocialPilot - pricing, features, API access, and who each platform is built for. Honest breakdown for developers and SaaS builders.
- [bundle.social vs SocialBee](https://info.bundle.social/comparison/socialbee.md): Comparing bundle.social with SocialBee - pricing, features, API access, and who each platform is built for. Honest breakdown for developers and SaaS builders.
- [bundle.social vs Planoly](https://info.bundle.social/comparison/planoly.md): Comparing bundle.social with Planoly - pricing, features, API access, and who each platform is built for. Honest breakdown for developers and SaaS builders.
- [SECURITY](https://info.bundle.social/SECURITY.md)

## OpenAPI Specs

- [swagger-json](https://api.bundle.social/swagger-json)

## Optional

- [Dashboard](https://bundle.social/dashboard)
- [Github](https://github.com/bundleglobal)
- [Status](https://bundlesocial.betteruptime.com)
- [Blog](https://bundle.social/blog)