conecto. Get started
Social

Read a post waiting for its owner

social_post_check · Reads only · Markdown

Reads a TikTok post waiting for its owner, with what to show and ask them from TikTok just now.

Free*

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

An example

What do I need to decide before the TikTok video goes up?

Your agent callssocial_post_checkFree*

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
{
  "check_id": "5f0c7a52-8a4e-4c1f-9d2b-3e6f1a7c9b40"
}
What comes back
{
  "check_id": "5f0c7a52-8a4e-4c1f-9d2b-3e6f1a7c9b40",
  "channel_id": "clx0d6k2v0003",
  "network": "tiktok",
  "network_name": "TikTok",
  "status": "waiting",
  "publish_at": null,
  "expires_at": "2026-10-17T08:00:00+00:00",
  "post_id": null,
  "confirm_url": "https://api.conecto.chat/v1/post/Qm8vH2sXkL4dT9rWp1cNfZ6yJ3uB0aEgM7tVxR5oKiY",
  "post": {
    "kind": "video",
    "caption": "The Tabor gravel bike, out on Skyline Blvd.",
    "media": [
      "https://social.cncto.co/uploads/2026/10/14/7b2e9c41d0a64f3e8c1b5a2d9e7f6c30.mp4"
    ],
    "seconds": 24.6
  },
  "can_post_now": true,
  "account": {
    "nickname": "Halverson Cycle",
    "username": "halversoncycle",
    "avatar_url": "https://p16.tiktokcdn.com/a.jpg"
  },
  "who_can_see": [
    {
      "value": "PUBLIC_TO_EVERYONE",
      "label": "Everyone"
    },
    {
      "value": "MUTUAL_FOLLOW_FRIENDS",
      "label": "Friends (followers you follow back)"
    }
  ],
  "allow": {
    "comments": "ask",
    "duet": "ask",
    "stitch": "off in their TikTok settings"
  },
  "disclosure": {
    "promotes_own_brand": "You are promoting yourself or your own business. TikTok labels the post \"Promotional content\".",
    "branded_content": "You are promoting another brand or a third party. TikTok labels the post \"Paid partnership\". It can't be \"Only me\"."
  },
  "declaration": {
    "plain": "By posting, you agree to TikTok's Music Usage Confirmation (https://www.tiktok.com/legal/page/global/music-usage-confirmation/en).",
    "with_branded_content": "By posting, you agree to TikTok's Branded Content Policy (https://www.tiktok.com/legal/page/global/bc-policy/en) and Music Usage Confirmation (https://www.tiktok.com/legal/page/global/music-usage-confirmation/en)."
  },
  "ask_owner": "TikTok needs the account's owner to make these choices, so ask them in your chat and never choose for them. Show them the account (nickname and username) and the post (its media and caption, which they may change). Ask who can see it, offering only who_can_see, with nothing picked for them. Ask whether to allow each of allow (off unless they say yes; one marked off stays off), and whether the post promotes their own brand or another brand (disclosure; off unless they say yes;…",
  "max_video_seconds": 600
}

Use it when

A TikTok post came back under waiting_for_owner and the owner should answer in your chat.

What it does

A TikTok post social_post holds for its owner, with what to show them and ask in your chat, read from TikTok just now: the account it goes to, who_can_see (the audiences this account allows), allow (the interactions to ask about, or marked off in their TikTok settings), the disclosure labels, the declaration to show word for word and ask_owner, how to ask. can_post_now false says why it can't go now: TikTok won't take a post from the account, or the video is longer than the account may post. Then social_confirm_post with their answer. Free.

What comes back

The post (media, caption, a photo post's title, a video's seconds), the TikTok account it goes to, who_can_see (the audiences the account allows), allow (the interactions to ask about, or marked off in their TikTok settings), the disclosure labels, the declaration to show word for word, ask_owner (how to ask), confirm_url, and can_post_now with the reason when TikTok won't take a post now or the video is longer than the account may post. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
check_idRequiredstringA check_id from social_post's waiting_for_owner. Exactly 36 characters.

The call

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

Terminal
curl -X POST https://api.conecto.chat/v1/tools/social_post_check \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"check_id":"5f0c7a52-8a4e-4c1f-9d2b-3e6f1a7c9b40"}'

When it refuses

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

CodeWhenWhat to do
not_found404No post waiting for the business's owner has that check_id.Use the check_id social_post gave under waiting_for_owner.
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