Connecting Accounts
Platform-by-platform guides for connecting your social media accounts to SonetHub, including setup requirements and available features.
Overview
SonetHub connects to your social media accounts via secure OAuth authorization. When you click Connect Account on the Accounts page, you're redirected to the platform's official login screen to grant permissions. SonetHub never sees your social media password — only a secure access token that can be revoked at any time.
All tokens are encrypted at rest and are automatically refreshed before they expire.
General Steps
- Go to the Accounts page from the sidebar
- Click Connect Account and choose a platform
- You'll be redirected to the platform's authorization page
- Log in (if needed) and approve the requested permissions
- You'll be redirected back to SonetHub with the account connected
Each platform has its own requirements and setup steps, detailed below.
Requirements
- Account type: Instagram Business or Creator account (personal accounts are not supported)
- Facebook Page: Your Instagram account must be connected to a Facebook Page
- Facebook role: You must have admin access or be able to manage the connected Facebook Page
Why a Professional Account?
Instagram's API only supports Business and Creator accounts. Personal accounts cannot be accessed by third-party apps for publishing, analytics, or messaging. Switching is free and takes under 5 minutes.
Step 1: Switch to a Professional Account
If your Instagram account is still personal, switch it first:
- Open the Instagram app on your phone
- Go to your Profile and tap the menu (three lines, top right)
- Tap Settings and privacy
- Tap Account type and tools
- Tap Switch to professional account
- Choose a category that best describes you or your business
- Select Business or Creator depending on your needs:
- Business — Best for brands, shops, and companies. Gives access to contact buttons, shopping, and ads
- Creator — Best for influencers, artists, and public figures. Offers flexible profile controls and creator-specific insights
- Follow the remaining prompts to complete setup
Important: Switching to a Professional account makes your profile public. All pending follow requests will be accepted automatically. You can switch back to personal at any time from the same menu.
For official instructions, see Set up a professional Instagram account.
Step 2: Connect a Facebook Page
Your Instagram Professional account needs a linked Facebook Page for the API to work:
- Open the Instagram app and go to your Profile
- Tap Edit profile
- Under Public business information, tap Page
- Choose an existing Facebook Page or create a new one
- Make sure you log in with the Facebook account that has admin access to the Page
You can also do this from Facebook: go to your Page Settings > Linked Accounts > Instagram and click Connect Account.
For official instructions, see Add or change the Facebook Page connected to your Instagram professional account.
Step 3: Connect in SonetHub
- Go to Accounts and click Connect Account > Instagram
- Log in to Facebook when prompted (since Instagram API access goes through Meta)
- Select the Facebook Page linked to your Instagram account
- Approve all requested permissions
- You'll be redirected back to SonetHub with your Instagram account connected
Available Features
| Feature | Supported | Notes |
|---|---|---|
| Photo posts | Yes | Single image feed posts |
| Reels (video) | Yes | Short-form video with optional cover image |
| Carousels | Yes | Multiple images and/or videos in one post |
| Stories | Yes | 24-hour ephemeral image or video content |
| Hashtag search | Yes | Search public posts by hashtag |
| Profile lookup | Yes | Look up other Business/Creator accounts |
| Comments | Yes | View, reply to, and delete comments |
| Mention monitoring | Yes | @mentions via webhook, comments via webhook + polling |
| Direct messages | Yes | Read and reply to DMs from the inbox |
| Post analytics | Yes | Likes, comments, shares, saves, reach, impressions |
| Story insights | Yes | Exits, replies, taps (available within 24 hours) |
| Account metrics | Yes | Followers, following, post count, reach |
| AI content generation | Yes | Generate and adapt content for Instagram |
Limitations
- Text-only posts are not supported — Instagram requires at least one image or video
- Hashtag search is limited to 30 unique hashtags per 7-day rolling window
- Story insights are only available for 24 hours after publication
- Profile lookup only works for other Business or Creator accounts (not personal)
- Instagram DMs require the
instagram_manage_messagespermission, which is requested during connection
Requirements
- Facebook Page: You must manage at least one Facebook Page (not a personal profile)
- Page role: You need admin access or the ability to perform
CREATE_CONTENTandMANAGEtasks on the Page
About Facebook Pages
SonetHub connects to Facebook Pages, not personal profiles. A Facebook Page represents a business, brand, organization, or public figure. If you don't have one yet, you can create a Facebook Page for free.
Connect in SonetHub
- Go to Accounts and click Connect Account > Facebook
- Log in to Facebook when prompted
- Select which Pages you'd like SonetHub to manage
- Approve all requested permissions
- You'll be redirected back to SonetHub with your Facebook Page connected
Tip: If you manage multiple Pages, SonetHub will connect to the first available Page. You can disconnect and reconnect to select a different one.
Available Features
| Feature | Supported | Notes |
|---|---|---|
| Text posts | Yes | Post text-only updates to your Page |
| Photo posts | Yes | Single or multi-photo posts |
| Video posts | Yes | Videos uploaded via resumable chunked upload |
| Reels | Yes | Short-form video to the Reels tab |
| Stories | Yes | 24-hour photo or video stories |
| Scheduled posts | Yes | Schedule via Facebook's native API (10 min to 75 days ahead) |
| Edit published posts | Yes | Edit the message text of existing posts |
| Comments | Yes | View, reply to, and delete comments |
| Mention monitoring | Yes | @mentions via webhook, comments via webhook + polling |
| Direct messages | Yes | Read and reply to Messenger conversations |
| Reactions breakdown | Yes | Like, Love, Wow, Haha, Sorry, Angry counts |
| Post analytics | Yes | Impressions, engaged users, clicks, reactions |
| Video insights | Yes | Views, complete views, average watch time |
| Account metrics | Yes | Page info, post count, page views |
| AI content generation | Yes | Generate and adapt content for Facebook |
Limitations
- SonetHub connects to Pages only — posting to personal profiles is not supported
- Messaging window: You can only reply to Messenger conversations within 24 hours of the user's last message
- Some advanced metrics (detailed reaction breakdowns, comment counts) may require Advanced Access approval from Meta
- Facebook Page tokens are effectively permanent but are re-exchanged periodically to ensure freshness
X / Twitter
Requirements
- Any X/Twitter account — No special account type needed
- Premium features (tweet editing) require an X Premium subscription
Connect in SonetHub
- Go to Accounts and click Connect Account > X / Twitter
- Log in to your X/Twitter account when prompted
- Review and approve the requested permissions
- You'll be redirected back to SonetHub with your account connected
The connection uses OAuth 2.0 with PKCE for maximum security — no secrets are exposed in the browser.
Available Features
| Feature | Supported | Notes |
|---|---|---|
| Tweets | Yes | Post tweets up to 280 characters |
| Images | Yes | Up to 4 images per tweet |
| Videos / GIFs | Yes | 1 video or GIF per tweet |
| Threads | Yes | Multi-tweet threads as connected replies |
| Polls | Yes | 2-4 options, custom duration |
| Quote tweets | Yes | Quote-repost another tweet with your commentary |
| Reply settings | Yes | Restrict who can reply (everyone, followers, mentioned) |
| Edit tweets | Yes | Requires X Premium; 30-min window, max 5 edits |
| Delete tweets | Yes | Full deletion |
| Direct messages | Yes | Read and reply to DMs |
| Search | Yes | Search recent tweets (last 7 days) |
| Post analytics | Yes | Likes, replies, retweets, quotes, bookmarks, impressions |
| Account metrics | Yes | Followers, following, tweet count |
| AI content generation | Yes | Generate and adapt content within 280 characters |
Limitations
- 280-character limit on tweets (enforced automatically)
- Media: 4 images OR 1 video/GIF per tweet — you cannot mix images and video
- Tweet editing requires an X Premium subscription and is limited to 30 minutes after posting with a maximum of 5 edits
- Tweet search returns results from the last 7 days only
- X/Twitter access tokens expire every 2 hours but are refreshed automatically by SonetHub
- DM history is limited to the last 30 days
- API usage limits — X/Twitter charges per API operation, so SonetHub enforces monthly operation limits per plan (50–2,000 operations). See Platform API Limits for details.
- Automated DM sync is not available — DMs are not synced automatically. You can still read and reply to DMs on-demand via the AI assistant.
SonetHub supports two types of LinkedIn connections: Personal Profiles and Company Pages. Each uses a separate LinkedIn app and OAuth flow due to LinkedIn API requirements.
LinkedIn Profile
Requirements
- Personal LinkedIn account — Any LinkedIn member can connect
Connect in SonetHub
- Go to Accounts and click Connect Account > LinkedIn Profile
- Log in to your LinkedIn account when prompted
- Review and approve the requested permissions (profile access and social posting)
- You'll be redirected back to SonetHub with your account connected
LinkedIn Page
Requirements
- LinkedIn Company Page — You must be an administrator of the Company Page you want to connect
- LinkedIn approval — Company Page posting uses the Community Management API, which requires LinkedIn business verification and approval. If this feature isn't yet available, you'll see a notice when attempting to connect.
Connect in SonetHub
- Go to Accounts and click Connect Account > LinkedIn Page
- Log in to LinkedIn when prompted
- Approve the requested permissions (organization posting and reading)
- SonetHub will automatically detect Company Pages where you are an admin and connect the first one
- You'll be redirected back to SonetHub with your Company Page connected
Note: LinkedIn requires a separate app for Company Page management (Community Management API) versus personal profile posting. This is a LinkedIn platform requirement, not a SonetHub limitation. Both connections can coexist — you can have both a personal profile and a company page connected at the same time.
Available Features
| Feature | Profile | Page | Notes |
|---|---|---|---|
| Text posts | Yes | Yes | Up to 3,000 characters |
| Image posts | Yes | Yes | Single or multi-image posts |
| Video posts | Yes | Yes | Uploaded via chunked upload |
| PDF documents | Yes | Yes | Swipeable PDF carousel posts |
| Articles (links) | Yes | Yes | Link posts with title and commentary |
| Edit published posts | Yes | Yes | Edit post text/commentary |
| Delete posts | Yes | Yes | Full deletion |
| Comments | Yes | Yes | View, reply to, and delete comments |
| Mention monitoring | Yes | Yes | Comment polling every 30 min (no @mention webhooks) |
| Post analytics | Yes | Yes | Likes, comments, shares |
| AI content generation | Yes | Yes | Generate professional thought-leadership content |
Limitations
- No direct messages — LinkedIn DMs are not available through the API
- No Stories — LinkedIn does not have a stories feature
- Limited account metrics — Follower count and detailed analytics require the LinkedIn Marketing API, which is restricted to approved partners
- LinkedIn access tokens are valid for 60 days and are refreshed automatically; refresh tokens last approximately 1 year
- Company Page availability depends on LinkedIn approving the Community Management API for SonetHub. If not yet approved, the "LinkedIn Page" option will show an unavailable message
Threads
Requirements
- Threads account — Any Threads account can connect
- Public profile recommended — Private profiles can connect but permission grants expire after 90 days and cannot be renewed without re-authorization
Connect in SonetHub
- Go to Accounts and click Connect Account > Threads
- Log in to your Threads/Instagram account when prompted
- Review and approve the requested permissions
- You'll be redirected back to SonetHub with your Threads account connected
Note: Threads uses a separate authorization from Instagram, even though they share the same underlying account. You'll need to connect each one individually.
Available Features
| Feature | Supported | Notes |
|---|---|---|
| Text posts | Yes | Up to 500 characters — no media required |
| Photo posts | Yes | Single image posts |
| Video posts | Yes | Video content with processing |
| Carousels | Yes | Multi-image posts |
| Polls | Yes | Create polls with voting options |
| Reply controls | Yes | Open, closed, or accounts-you-follow |
| Link attachments | Yes | URL preview cards |
| Topic tags | Yes | Subject categorization for discovery |
| Location tagging | Yes | Geo-tag posts with searchable locations |
| Alt text | Yes | Accessibility text for media |
| Delete posts | Yes | Full deletion |
| Replies/comments | Yes | View and reply to comments (hides rather than deletes) |
| Mention monitoring | Yes | Comment polling every 30 min (no @mention webhooks) |
| Keyword search | Yes | Search public posts by keyword |
| Profile lookup | Yes | Find users by username |
| Post analytics | Yes | Likes, replies, reposts, quotes, bookmarks |
| Follower demographics | Yes | Country, city, age, gender (requires 100+ followers) |
| Account metrics | Yes | Followers, following, post count, impressions |
| AI content generation | Yes | Generate conversational-style content |
Limitations
- 500-character limit on posts
- No direct messages — Threads does not support DMs via the API
- No post editing — Published Threads posts cannot be edited
- Comments are hidden rather than deleted when you remove them
- Private profiles: Permission grants expire after 90 days and must be re-authorized manually. Public profiles renew automatically
- Follower demographics require at least 100 followers
- Threads access tokens are valid for 60 days and are refreshed automatically
TikTok
Requirements
- TikTok account — Any TikTok user can authorize the app
- Video/photo content — TikTok does not support text-only posts
Supported Features
| Feature | Status | Notes |
|---|---|---|
| Video posts | Supported | Upload and publish videos via chunked file upload |
| Photo posts | Supported | Image posts (1-35 photos) with auto-music option |
| Privacy controls | Supported | Set audience for each post (public, followers, friends, private) |
| AIGC labeling | Supported | Mark AI-generated content |
| Brand content toggle | Supported | Commercial/brand post indicator |
| Post analytics | Supported | Views, likes, comments, shares |
| Account metrics | Supported | Followers, following, video count |
| Published video list | Supported | View your published videos with engagement metrics |
Known Limitations
- No text-only posts — All TikTok posts require media
- No DMs via the API
- No post editing or deletion via the API
- Comments and search require a TikTok Business connection (see below)
- Videos are published asynchronously — there may be a short delay before they appear
- TikTok access tokens expire every 24 hours (refreshed automatically)
TikTok Business
Requirements
- TikTok Business Account — Your TikTok account must be a Business account (not personal or creator)
- Existing TikTok connection — Connect your regular TikTok account first for publishing; TikTok Business is a separate connection for analytics and engagement
- 100+ followers — Required for demographic data (age, gender, country, city)
What It Adds
TikTok Business is a separate provider that connects via the TikTok Business API. It provides advanced features not available through the regular TikTok connection:
| Feature | Status | Notes |
|---|---|---|
| Enhanced video analytics | Supported | Retention curve, traffic sources, watch time, completion rate |
| Audience demographics | Supported | Age, gender, country, city breakdown (100+ followers required) |
| Industry benchmarks | Supported | Compare your metrics against 24 industry categories |
| Comment management | Supported | List, reply, delete, like/unlike, hide/unhide comments |
| Brand mention monitoring | Supported | Track posts and comments that mention your brand |
| Hashtag suggestions | Supported | Get TikTok-recommended hashtags with view counts |
| Trending sounds | Supported | Browse Commercial Music Library tracks |
| Trending search keywords | Supported | See what people are searching on TikTok |
How It Works
- TikTok Business appears as a separate card on the Accounts page
- It uses its own OAuth flow and stores its own tokens (separate from your regular TikTok account)
- Analytics and engagement features come from TikTok Business; publishing still goes through your regular TikTok account
YouTube
Requirements
- YouTube channel — Any channel type (personal or brand)
- YouTube Data API v3 access (handled automatically by SonetHub)
Supported Features
| Feature | Status | Notes |
|---|---|---|
| YouTube Shorts | Supported | Vertical video up to 60 seconds |
| Video analytics | Supported | Views, likes, comments |
| Account metrics | Supported | Subscribers, video count |
| Comment management | Supported | Read, reply to, and delete comments |
| Published video list | Supported | View your published videos |
Known Limitations
- Shorts only — Long-form video uploads are not supported
- No DMs/inbox — YouTube has no messaging API
- No post editing — Published Shorts cannot be modified, only deleted and re-uploaded
- Daily upload quota — Approximately 6 uploads per day shared across the workspace (YouTube API quota)
- No shares/saves/clicks — These metrics are not available in the YouTube API
Requirements
- Pinterest Business account — Personal accounts are not supported. You need a Pinterest Business account (free to create) or a personal account converted to Business.
- At least one board — You need at least one board on your Pinterest account to publish Pins.
About Pinterest Boards
Pinterest organizes content into boards. When publishing, you'll select which board to pin to. Boards act as thematic collections — "Summer Recipes," "Product Launches," "Design Inspiration" — and help your content get discovered by the right audience. You can create boards directly on Pinterest before connecting to SonetHub.
Connect in SonetHub
- Go to Accounts and click Connect Account > Pinterest
- Log in to your Pinterest Business account when prompted
- Review and approve the requested permissions
- You'll be redirected back to SonetHub with your Pinterest account connected
The connection uses OAuth 2.0 via the Pinterest API v5.
Available Features
| Feature | Supported | Notes |
|---|---|---|
| Image Pins | Yes | Single image with title, description, and destination URL |
| Video Pins | Yes | Upload and publish video Pins |
| Board selection | Yes | Choose which board to pin to when publishing |
| Title field | Yes | Up to 100 characters |
| Description | Yes | Up to 500 characters |
| Destination URL | Yes | Link-driven — every Pin can link to your website |
| Alt text | Yes | Accessibility text for images (up to 500 characters) |
| Pin analytics | Yes | Impressions, saves, clicks, outbound clicks |
| Account metrics | Yes | Followers, following, pin count |
| AI content generation | Yes | Generate and adapt content for Pinterest |
Limitations
- No text-only posts — Every Pin requires an image or video. Text-only Pins are not supported.
- No native carousel — Pinterest does not support multi-image carousel Pins via the API. Multiple images will be published as separate Pins.
- No comments management — Pinterest does not expose a comments API. You cannot view, reply to, or delete comments through SonetHub.
- No direct messages — Pinterest does not have a DM API. Inbox features are not available for Pinterest.
- No hashtags — Pinterest does not use hashtags for discovery. Use keywords naturally in your Pin title and description instead.
- No content search via API — Searching for Pins or users is not available through the Pinterest API.
- No webhooks or mention monitoring — Pinterest does not support webhook events or @mention notifications.
- Pinterest access tokens are valid for 30 days and are refreshed automatically by SonetHub.
Managing Connected Accounts
Viewing Your Accounts
All connected accounts appear on the Accounts page with their profile picture, username, platform, and connection status.
Disconnecting an Account
To disconnect an account, click the Disconnect button next to the account on the Accounts page. This:
- Revokes SonetHub's access to that account
- Removes stored tokens from SonetHub's servers
- Deletes associated post tracking data
- Does not delete any content already published to the platform
Token Refresh
SonetHub automatically refreshes your access tokens before they expire. You don't need to reconnect unless:
- You manually revoke access from the platform's settings
- Your account is suspended or deactivated
- Permissions change on the platform side (e.g., Facebook Page role changes)
If a token becomes invalid, you'll see a warning on the Accounts page prompting you to reconnect.
Troubleshooting
"No Instagram Business account linked"
This error means SonetHub couldn't find a Business or Creator Instagram account connected to any of your Facebook Pages. Make sure you've:
- Switched your Instagram account to Professional (Business or Creator)
- Connected it to a Facebook Page (see Step 2 above)
- Logged into the correct Facebook account that manages that Page during authorization
"Authorization denied"
This appears when you click "Cancel" or "Deny" on the platform's authorization screen. Try connecting again and make sure to approve all requested permissions.
"Invalid OAuth state"
This security error occurs when the connection flow is interrupted — for example, if you opened the authorization in a new tab or your session expired. Try connecting again from the Accounts page.
Account Not Appearing After Connection
If you completed the authorization but don't see the account:
- Refresh the page — the account list may need to reload
- Check if the platform returned an error in the URL bar (look for
?error=...) - Ensure you have available account slots on your plan (Free: 3, Creator: 5, Pro: 15, Business: 30)
- Try disconnecting and reconnecting the account
Facebook Page Not Found
If SonetHub can't find your Facebook Page during connection:
- Make sure you have admin access to the Page
- Check that the Page is published (not unpublished/draft)
- If the Page is managed through Business Manager, ensure your personal account has the necessary permissions
- Try logging into Facebook directly and confirming you can see the Page under "Your Pages"
Tokens Expired / Reconnection Required
If you see a warning about expired tokens:
- Click Reconnect or disconnect and reconnect the account
- The re-authorization flow is the same as the initial connection
- All your post history and settings will be preserved
For platform-specific issues, check the platform's own help center: