> ## Documentation Index
> Fetch the complete documentation index at: https://magic-post.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect channels

> Link your social accounts, choose which ones to publish to, check their health, reconnect expired ones and stay within your plan limit.

A channel is one account or destination that MagicPost publishes to, such as an X profile, a LinkedIn page, a Facebook Page, a WhatsApp group or a Telegram channel. You connect channels once on the **Channels** page, then pick them in the composer for every post.

Open **Publishing → Channels** in the sidebar.

> [!NOTE]
>
> The networks you can connect depend on your administrator. Each network needs its developer app credentials entered under **Publishing → Platforms** in the admin panel first. If you see **No networks are available yet**, the apps are not registered. See [Publishing channels](https://magic-post.mintlify.site/channels/overview.md).

## Networks you can connect

MagicPost can publish to X (Twitter), LinkedIn, Facebook Pages, Instagram, TikTok, YouTube, Pinterest, Threads, WhatsApp and Telegram. Each network has its own account requirements and limits. Read its page before you connect:

> [card] [X](https://magic-post.mintlify.site/channels/x.md)

> [card] [LinkedIn](https://magic-post.mintlify.site/channels/linkedin.md)

> [card] [Facebook](https://magic-post.mintlify.site/channels/meta/facebook.md)

> [card] [Instagram](https://magic-post.mintlify.site/channels/meta/instagram.md)

> [card] [Threads](https://magic-post.mintlify.site/channels/meta/threads.md)

> [card] [TikTok](https://magic-post.mintlify.site/channels/tiktok.md)

> [card] [YouTube](https://magic-post.mintlify.site/channels/youtube.md)

> [card] [Pinterest](https://magic-post.mintlify.site/channels/pinterest.md)

> [card] [WhatsApp](https://magic-post.mintlify.site/channels/whatsapp/overview.md)

> [card] [Telegram](https://magic-post.mintlify.site/channels/telegram/overview.md)

## Connect a channel

**1. Open the Add a channel card**

On the Channels page, select **Add a channel** at the top right, or scroll to the **Add a channel** card. It lists every network that is available to you.

**2. Choose a network**

Select the network. You are sent to that network's site to authorise MagicPost, then returned to the Channels page.

**3. Approve access**

Sign in on the network if asked and approve the permissions MagicPost requests. Declining returns you to Channels with **The connection was cancelled.**

**4. Pick accounts if asked**

When one authorisation gives access to several accounts, such as the Pages you manage, a **Choose accounts to connect** window opens. Tick the accounts you want and select **Connect**. Each account you pick counts as one channel.

**5. Confirm**

A message such as **Name is connected.** or **N channels connected** confirms the result. The channel appears in the list with the **Active** tag.

> [!TIP]
>
> Connect from a browser where you are signed in to the right account on the network. The account that authorises the connection is the one MagicPost links.

### WhatsApp

WhatsApp does not send you to the network's site. Selecting it opens a MagicPost page where you link a number. A window then lists the number's groups, and its WhatsApp Channels and Status where the provider supports them, so you can pick where to post. Nothing is ticked for you, because a number can sit in hundreds of groups and each one you pick counts as a channel. The steps depend on the provider your administrator chose: [WAHA](https://magic-post.mintlify.site/channels/whatsapp/waha.md), [Whapi.Cloud](https://magic-post.mintlify.site/channels/whatsapp/whapi.md) or the [Official Cloud API](https://magic-post.mintlify.site/channels/whatsapp/official-cloud-api.md). See also [WhatsApp channels](https://magic-post.mintlify.site/channels/whatsapp/overview.md).

### Telegram

Telegram does not send you to the network's site either. Selecting it opens the **Connect Telegram** page, where you:

1. Link your Telegram account by pressing **Start** in a chat with the bot. Where your administrator allows it, you can paste the token of a bot of your own first.
2. Add the bot to a Telegram channel or group you run, as an admin.

Each chat you add becomes one channel, and it is connected when Telegram confirms that a linked account of yours is an admin of the chat. The steps are on [Set up Telegram](https://magic-post.mintlify.site/channels/telegram/setup.md#part-2-connect-a-channel-or-group), and post limits are on [Telegram channels](https://magic-post.mintlify.site/channels/telegram/overview.md).

## What you see for each channel

Each channel card shows the avatar, name, network and handle, the channel type, and its groups. A status tag shows its state:

| Tag | Meaning |
| - | - |
| **Active** | Connected and ready to publish. |
| **Paused** | You paused it. Posts due for it wait until you resume it. |
| **Expired** | The network stopped accepting the saved authorisation. Reconnect it. |
| **Disconnected** | The connection was removed on the network side. Reconnect it. |
| **Cooling down** | The network asked MagicPost to slow down. Posting resumes by itself after the wait shown on hover. |
| **Not in your plan** | Your plan no longer includes this network. |

The summary tiles at the top of the page show **Connected** (for example `3 / 5`, with **slots left**), **Networks**, **Ready to publish** and **Published · 14 days**.

Use the network tabs, the **Search channels** box and **Filters** (by **Status** and **Group**) to narrow the list. The **Grid** and **List** buttons change the layout. You can also open a pre-filtered view with a link such as `/app/user/channels?status=reconnect`.

## Reconnect a channel

A channel needs reconnecting when it shows **Expired** or **Disconnected**. A banner at the top of the page lists these channels and warns that scheduled posts for them are skipped until the connection is restored.

**1. Start the reconnect**

Select the **Expired** or **Disconnected** tag, or open the actions menu on the card and choose **Reconnect**.

**2. Authorise again**

Approve access on the network, using the account you originally linked.

If you authorise a different account, MagicPost refuses with **That is a different account. Reconnect using the account you originally linked.** Reconnecting an existing channel never uses a new place in your plan, so you can always recover when you are at your limit.

For a WhatsApp number or a Telegram chat there is no network sign-in. **Reconnect** opens the MagicPost page for that network instead. For Telegram, add the bot back to the chat as an admin, then click **Check again**.

Many networks renew their authorisation automatically. For the ones that do not, the connection check shows the date until which the connection is valid.

## Check a connection

Open the actions menu on a card and choose **Check connection**, or select **Check** or **Check again** on the card. The **Connection check** window lists what MagicPost tested:

* **Authorisation** shows whether the connection renews by itself, does not expire, or expires on a date. You get a warning when it ends within seven days.
* **Live check** asks the network whether it still accepts the connection. Some networks cannot be asked without posting, and the window says so.
* **Paused** and **Rate limit** appear when you paused the channel or the network asked MagicPost to wait.

The overall result is **All good**, **Works, with notes** or **Needs attention**. A check can also mark a channel as needing a reconnect, or put an expired channel back into service when the network accepts it again.

Networks that support it offer **Send a private test**, which publishes a private test post so you can prove the whole path works. The window describes what the test does on that network before you run it.

MagicPost also checks channels in the background, so most problems show up before a scheduled post fails. See [Channel connection problems](https://magic-post.mintlify.site/troubleshooting/channel-connections.md).

## Pause and resume

Open the actions menu and choose **Pause**. While a channel is paused, nothing goes out to it. Choose **Resume** to bring it back. Posts that were waiting go out shortly afterwards. A channel that needs reconnecting cannot be resumed until you reconnect it.

A post scheduled for a paused channel waits for up to the hold time set by your administrator, then is not sent. The post page shows **Held until** and a **Resume channel** button. See [Posts and statuses](https://magic-post.mintlify.site/user-guide/posts-and-statuses.md).

## Disconnect a channel

> [!WARNING]
>
> Disconnecting removes the saved authorisation and skips every post still waiting to go out to that channel.

1. Open the actions menu on the channel and choose **Disconnect**.
2. Confirm **Disconnect this channel?** with **Disconnect**.

Posts the channel already published, and their analytics, stay in MagicPost. If you connect the same account again, it returns as the same channel with its history. A reconnected account counts against your channel limit again, because a disconnected channel stops taking a place.

For a WhatsApp number, **Disconnect this number** removes every group, WhatsApp Channel and Status linked to it at once. Disconnecting a Telegram channel does not remove the bot from the chat, so remove it in Telegram if you no longer want it there.

## Channel limit and plan

Your plan sets how many channels you can connect. The **Connected** tile shows the count and the places left. Reaching the limit has these effects:

* The **Add a channel** button at the top is hidden, and the networks in the **Add a channel** card are greyed out under a limit note.
* Starting a connection anyway returns **You have connected the maximum of N channels. Upgrade your plan to add more.**
* If your plan includes no channels at all, you see **Connecting channels is not included in your plan. Upgrade your plan to add channels.**
* When you pick several accounts at once and the limit is reached partway, the rest are skipped and a warning says how many.

A plan can also limit which networks you may use. Networks outside it show **Not in your plan** with an **Upgrade** link when billing is enabled. If you try to publish to such a channel, the save is refused with **Your plan does not include X. Remove those channels to save this post.** Plans are covered in [Billing and subscription](https://magic-post.mintlify.site/account/billing.md).

> [!NOTE]
>
> When billing is not turned on for the site, channels are not limited by a plan.

## Channel groups

Groups let you pick a set of channels in one click, for example all channels for one client.

1. Select **Groups** at the top of the Channels page.
2. Under **New group**, type a name such as `Client accounts`.
3. Tick the channels under **Channels in this group**.
4. Select **Save group**.

Group names must be unique for your account. To change a group, select the pencil icon next to it, rename it or change its channels, and save again. The trash icon deletes the group but not its channels. In the composer, your groups appear under **Sets** in the channel picker. See [Composer](https://magic-post.mintlify.site/user-guide/composer.md).

## Related pages

> [card] [Composer](https://magic-post.mintlify.site/user-guide/composer.md)
>
> Pick your channels and write a post.

> [card] [Posting queue](https://magic-post.mintlify.site/user-guide/scheduling.md)
>
> Set posting times per channel.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.