# Platform Guides — SquareMCP Docs

# Platform guides

Step-by-step instructions for connecting each platform. Click a platform to jump to its guide.

#### in LinkedIn

OAuth access token, post text and video.

#### 🎵 TikTok

Login Kit OAuth flow, upload video.

#### 💬 WhatsApp

Business API, templates, inbound webhooks.

#### 📷 Instagram

Business account, Graph API token.

#### 𝕏 Twitter / X

API v2 credentials, tweet with media.

#### ✈️ Telegram

Bot token from BotFather.

## in LinkedIn

### What you can do

- Post text updates, articles, images, and videos
- Search connections and send direct messages
- Retrieve your profile and network info

### Connecting LinkedIn

1. Create a LinkedIn app Go to linkedin.com/developers/apps and create a new app. Add your company page and request the `w_member_social` and `r_liteprofile` products.
2. Generate an access token Use the LinkedIn OAuth 2.0 token generator in your app dashboard, or use the 3-legged OAuth flow. Copy the access token (valid 60 days; refresh tokens extend to ~12 months).
3. Paste into SquareMCP dashboard Open the SquareMCP dashboard → LinkedIn → Connect → paste your access token → Save.

### Available tools

Example prompts

    Post a LinkedIn update: "Excited to announce our new product launch!"

    Post a LinkedIn video from /tmp/demo.mp4 with caption "Watch our product demo"

    Search my LinkedIn connections for people at Anthropic

    Send a LinkedIn message to John Smith saying "Great meeting you at the conference"

Token refresh LinkedIn access tokens expire after 60 days. SquareMCP will automatically attempt a refresh using the refresh token. If refresh fails (e.g., the user revokes access), reconnect from the dashboard.

## 🎵 TikTok

### What you can do

- Upload and publish videos with captions
- Set privacy level (public, friends, private)
- View creator info and video status

### Connecting TikTok

1. OAuth via SquareMCP dashboard Open the SquareMCP dashboard → TikTok → Connect. You'll be redirected to TikTok to authorise the app. SquareMCP uses TikTok Login Kit with `video.publish` and `user.info.basic` scopes.
2. Allow the requested permissions TikTok shows the requested scopes. Click Authorize. You'll be redirected back to the dashboard with a "Connected" badge.

### Uploading a video

Videos must be hosted at a publicly accessible URL. The tool uploads the video to TikTok's servers asynchronously — use `tiktok_get_video_status` to poll for completion.

Example prompts

    Upload the video at https://cdn.example.com/demo.mp4 to TikTok
    with caption "Check out our new feature! #AI #productlaunch"
    and set privacy to PUBLIC_TO_EVERYONE

    Check the status of my last TikTok upload

TikTok sandbox vs. production TikTok's Content Posting API requires app approval for production use. New apps start in sandbox mode (videos published to a test account only). Apply for production access through the TikTok developer portal.

## 💬 WhatsApp

### What you can do

- Send freeform messages and approved template messages
- Send images, documents, and media
- Receive inbound messages via webhook and forward to your AI agent
- List all approved message templates

### Prerequisites

You need a WhatsApp Business Account and a phone number registered through the Meta Business Manager.

### Connecting WhatsApp

1. Get your credentials from Meta In Meta for Developers → Your App → WhatsApp → API Setup:
   - Phone Number ID — the ID of your registered number
   - Business Account ID — your WABA ID
   - Permanent Access Token — generate from System Users in Business Manager
2. Enter credentials in dashboard Open SquareMCP dashboard → WhatsApp → Connect → paste all three values → Save.
3. Configure the webhook (optional — for inbound messages) In Meta for Developers → Webhooks, set the callback URL to `https://hermes.squaremcp.com/webhook/whatsapp` and the verify token to your `WA_VERIFY_TOKEN` (ask support for this). Subscribe to the `messages` field. Then configure a forwarding URL in SquareMCP dashboard → Webhooks so inbound messages reach your server.

### Sending messages

Freeform message (within 24-hour session window)

    Send a WhatsApp message to +447911123456 saying:
    "Hi! Your order #12345 has shipped and will arrive tomorrow."

Template message (anytime)

    List my WhatsApp message templates

    Send the "order_confirmation" template to +447911123456
    with variables: order_id=12345, delivery_date="14 May 2026"

24-hour rule WhatsApp only allows freeform messages within 24 hours of a customer contacting you first. Outside that window, use approved template messages.

## 📷 Instagram

### What you can do

- Publish image posts and reels
- View profile and recent media

### Connecting Instagram

Instagram posting requires a Business or Creator account connected to a Facebook Page.

1. Get a Graph API access token Open the Graph API Explorer, select your app, and request `instagram_basic`, `instagram_content_publish`, and `pages_read_engagement` permissions. Generate a User Access Token and exchange it for a long-lived token.
2. Find your Business Account ID Call `GET /me/accounts` then `GET /{page_id}?fields=instagram_business_account` to find your Instagram Business Account ID.
3. Enter credentials in dashboard SquareMCP dashboard → Instagram → Connect → paste the access token and Business Account ID.

Example prompts

    Post an Instagram reel from https://cdn.example.com/reel.mp4
    with caption "Behind the scenes of our product shoot 🎬 #startup"

    Get my last 10 Instagram posts

## 𝕏 Twitter / X

### Connecting Twitter / X

1. Create a developer app Go to developer.twitter.com and create a project and app. Enable OAuth 1.0a with Read and Write permissions.
2. Generate all four credentials In your app → Keys and tokens: copy the API Key, API Secret, Access Token, and Access Token Secret (all four are required).
3. Enter credentials in dashboard SquareMCP dashboard → Twitter / X → Connect → paste all four values.

Example prompts

    Tweet: "We just shipped our v2 release 🚀 Read the changelog at squaremcp.com"

    Upload the video at /tmp/demo.mp4 and tweet "Watch our new feature demo!"

    Search Twitter for tweets mentioning "SquareMCP"

## ✈️ Telegram

### Connecting Telegram

1. Create a bot with BotFather Open Telegram and message `@BotFather`. Send `/newbot`, choose a name and username, and copy the API token it provides (format: `123456789:ABCdef...`).
2. Enter the token in dashboard SquareMCP dashboard → Telegram → Connect → paste the bot token.
3. Add your bot to a chat or group Bots can only send messages to chats they're a member of. Add your bot to the target chat, then use `telegram_get_updates` to find the chat ID.

Example prompts

    Send a Telegram message to chat ID -1001234567890 saying "Daily report ready!"

    Get the latest Telegram messages in my channel