conecto. Get started
Social

List the connected channels

social_channels · Reads only · Markdown

The business's connected social accounts (channels), with their network, name and profile.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

An example

Which social accounts are connected right now?

Your agent callssocial_channelsFree*

The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.

With these arguments
{}
What comes back
{
  "channels": [
    {
      "channel_id": "ch0001x5396ee00",
      "network": "linkedin",
      "network_name": "LinkedIn (personal profile)",
      "name": "Halverson Cycle & Repair",
      "profile": "halversoncycle&repair",
      "picture": "https://social.cncto.co/uploads/p/ch0001x5396ee00.png",
      "disabled": false
    },
    {
      "channel_id": "ch0002x57b59249",
      "network": "bluesky",
      "network_name": "Bluesky",
      "name": "halversoncycle.bsky.social",
      "profile": "halversoncycle.bsky.social",
      "picture": "https://social.cncto.co/uploads/p/ch0002x57b59249.png",
      "disabled": false
    }
  ],
  "count": 4
}

Use it when

To find a channel_id before posting, or to see what is connected.

What it does

The business's connected social accounts (channels), with their network, name and profile. Free.

What comes back

Every channel with its channel_id, network, name, profile and picture, whether it is switched off or needs reconnecting, and how many. A channel on the business's own bot or webhook has own: bot or webhook. Every reply also carries cost_usd and balance_usd.

The call

Over MCP, call social_channels on https://api.conecto.chat/mcp/social. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/social_channels \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
not_switched_on503Social posting is not switched on yet.Try again later; nothing was charged.
social_unavailable503The posting service did not answer, or could not open the business's social workspace.Call again in a minute; when the message says so, tell Conecto's support.
refused400The posting service refused the request; the message gives its reason.Fix what the reason names, then call again.
refused422The posting service reported a conflict with what is there.Read the channel or post again, then call again.
rate_limited429The posting service's limit of posts an hour was reached.Try again later.

More Social tools

All 13 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md