Connecting Social Media Platforms

Connecting your social media accounts to bluekona.ai is the first step to unlocking powerful AI-driven insights. This guide explains how connections work, what permissions we need, and why your data is always secure.

Why Connect Your Accounts?

bluekona.ai needs access to your social media analytics to:

• Retrieve performance metrics (views, engagement, reach)
• Analyze your content and posting patterns
• Identify trends in audience behavior
• Generate personalized recommendations

Without connecting accounts, we can't provide insights specific to your brand.

Security & Privacy First

No Passwords Stored

We never ask for or store your social media passwords. All connections use OAuth, an industry-standard authorization protocol where you log in directly on the platform's website.

Read-Only Access

bluekona.ai requests read-only permissions only. This means:

• ✅ We can view your analytics and metrics
• ✅ We can see your published content
• ❌ We cannot post on your behalf
• ❌ We cannot modify or delete your content
• ❌ We cannot access your messages or private information

Secure Connection Process

1. You click "Connect" in bluekona.ai
2. You're redirected to the platform's official OAuth page
3. You log in directly on the platform (Facebook, Instagram, etc.)
4. You review and approve the permissions
5. You're redirected back to bluekona.ai with a secure token

Your Control

You maintain full control:

• Revoke access anytime from your bluekona.ai settings
• Revoke access from the social platform's settings
• Tokens automatically expire and require refresh
• No automatic renewals without your action

Supported Platforms

bluekona.ai currently supports:

Connection Requirements

Account Types

Some platforms require specific account types to access analytics:

Instagram: Must be a Business or Creator account (free upgrade from personal) TikTok: Must be a Business account (free switch from personal) Facebook: Must be a Page (not personal profile) LinkedIn: Must be a Company Page

Personal accounts don't provide API access to analytics, which is why business/creator accounts are required.

Admin/Owner Access

You need admin or owner permissions for:

• Facebook Pages
• Instagram Business accounts
• LinkedIn Company Pages
• YouTube Channels

If you don't have admin access, ask the page owner to connect the account.

What Data We Collect

Performance Metrics

• Views, impressions, reach
• Likes, comments, shares
• Follower counts and growth
• Click-through rates

Content Information

• Post captions and descriptions
• Post types (image, video, carousel)
• Publishing dates and times
• Hashtags used

Audience Insights (when available)

• Demographics (age, gender, location)
• Engagement patterns
• Best posting times

What We Don't Collect

• Private messages or DMs
• Personal profile information beyond your public bio
• Payment or financial information
• Passwords or login credentials
• Unpublished drafts

Connection Limits

Free Tier

Connect up to [X] social media accounts (check your plan for limits)

Paid Tiers

Higher limits based on your subscription level

Internal Users and Special Invite Users

Unlimited connections for testing and support purposes

How Long Do Connections Last?

Token Expiration

Social media platforms use security tokens that expire:

• Facebook/Instagram: 60 days
• YouTube: Indefinite (until manually revoked)
• LinkedIn: 60 days
• Threads: 60 days
• TikTok: Variable based on platform settings
• X (Twitter): Indefinite (until manually revoked)

Refreshing Connections

When a token expires:

1. You'll see an "Expired" status in your dashboard
2. Click "Reconnect" to refresh
3. Re-authorize through OAuth
4. Your historical data remains intact

Getting Started

Ready to connect your first platform? Choose your guide:

• Connect Facebook Page
• Connect Instagram
• Connect YouTube
• Connect X (Twitter)
• Connect Threads
• Connect TikTok
• Connect LinkedIn

After connecting, learn how to manage your connections.

Troubleshooting

Having trouble connecting? Check our common issues guide or learn about token expiration.

Need Help?

If you encounter issues during the connection process:

1. Ensure you're logged into the correct social media account
2. Verify you have admin/owner permissions
3. Check that you're using the required account type (Business, Creator, etc.)
4. Try disabling browser extensions that might block OAuth
5. Clear your browser cache and try again

For platform-specific guidance, see the detailed connection guides above.