Find a free time to post
The next free time to post on a channel, from its posting times and what is already scheduled.
Free*
*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.
An example
When's the next good time to post on our LinkedIn page?
Your agent callssocial_find_slotFree*
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.
{
"channel_id": "clx0d6k2v0001"
}Use it when
The owner wants a post to go out at a good time without naming one.
What it does
The next free time slot of a channel, from the posting times Postiz keeps for it and what is already scheduled: pass it as when to social_post. Free.
What comes back
The channel_id and when: the next free time slot, to pass as when to social_post. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
channel_idRequired | string | A channel_id from social_channels. 1 to 64 characters, matches ^[A-Za-z0-9_-]+$. |
The call
Over MCP, call social_find_slot on https://api.conecto.chat/mcp/social. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/social_find_slot \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"channel_id":"clx0d6k2v0001"}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
no_channels409 | The business has no connected channel yet. | Connect one with social_connect. |
not_switched_on503 | Social posting is not switched on yet. | Try again later; nothing was charged. |
social_unavailable503 | The 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. |
refused400 | The posting service refused the request; the message gives its reason. | Fix what the reason names, then call again. |
refused422 | The posting service reported a conflict with what is there. | Read the channel or post again, then call again. |
rate_limited429 | The posting service's limit of posts an hour was reached. | Try again later. |
More Social tools
All 13 tools- List the social networks
social_networksEvery network the business can post to, how each connects (a link, a login, Telegram's code, or its own bot or webhook), and whether it is switched on yet.Free* - Connect a social account
social_connectConnects one of the business's own social accounts as a channel: by a link for the owner, a login, or a code posted in a Telegram channel.Free - List the connected channels
social_channelsThe business's connected social accounts (channels), with their network, name and profile.Free* - Read a channel's rules
social_channel_rulesWhat a channel's network accepts: lengths, media counts, the settings a post needs, and its lookups.Free* - Look something up on a channel
social_channel_lookupRuns one of a channel's lookups, like the channels of a Discord server or the boards on Pinterest.Free* - Post to social channels
social_postPosts now or at a set time to one or several channels, with pictures, video or a thread.$0.02 per channel posted to - Read a post waiting for its owner
social_post_checkReads a TikTok post waiting for its owner, with what to show and ask them from TikTok just now.Free* - Answer for the owner of a post
social_confirm_postPosts a TikTok post waiting for its owner with the choices they made in your chat, or drops it.Free
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md