--- name: "social_post_check" area: "social" title: "Read a post waiting for its owner" price: "free" method: "POST" url: "https://api.conecto.chat/v1/tools/social_post_check" mcp_server: "https://api.conecto.chat/mcp/social" auth: "Authorization: Bearer " docs_url: "https://conecto.chat/tools/social/social_post_check" --- # Read a post waiting for its owner (`social_post_check`) Reads a TikTok post waiting for its owner, with what to show and ask them from TikTok just now. 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. Price: Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads. A call that fails costs nothing. ## Use it when A TikTok post came back under waiting_for_owner and the owner should answer in your chat. ## Say this to your agent > What do I need to decide before the TikTok video goes up? ## Inputs | Name | Type | Required | Description | Allowed values | Default | |---|---|---|---|---|---| | `check_id` | string | yes | A check_id from social_post's waiting_for_owner. Exactly 36 characters. | | | ## Example Written for Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. MCP: call `social_post_check` on the MCP server `https://api.conecto.chat/mcp/social` with these arguments: ```json { "check_id": "5f0c7a52-8a4e-4c1f-9d2b-3e6f1a7c9b40" } ``` REST: ```bash curl 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"}' ``` ## Response ```json { "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93", "tool": "social_post_check", "status": "succeeded", "replayed": false, "cost_usd": "$0.00", "balance_usd": "$19.75", "result": { "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 } } ``` `result`: 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. ## Errors | Code | Status | When | Fix | |---|---|---|---| | `not_found` | 404 | No post waiting for the business's owner has that check_id. | Use the check_id social_post gave under waiting_for_owner. | | `not_switched_on` | 503 | Social posting is not switched on yet. | Try again later; nothing was charged. | | `social_unavailable` | 503 | 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. | | `refused` | 400 | The posting service refused the request; the message gives its reason. | Fix what the reason names, then call again. | | `refused` | 422 | The posting service reported a conflict with what is there. | Read the channel or post again, then call again. | | `rate_limited` | 429 | The posting service's limit of posts an hour was reached. | Try again later. | The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md ## Related - [social_networks](https://conecto.chat/tools/social/social_networks.md): Every 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 up to 1,000,000 reads a month. - [social_connect](https://conecto.chat/tools/social/social_connect.md): Connects 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. - [social_channels](https://conecto.chat/tools/social/social_channels.md): The business's connected social accounts (channels), with their network, name and profile. Free up to 1,000,000 reads a month. - [social_channel_rules](https://conecto.chat/tools/social/social_channel_rules.md): What a channel's network accepts: lengths, media counts, the settings a post needs, and its lookups. Free up to 1,000,000 reads a month. - [social_channel_lookup](https://conecto.chat/tools/social/social_channel_lookup.md): Runs one of a channel's lookups, like the channels of a Discord server or the boards on Pinterest. Free up to 1,000,000 reads a month. - [social_find_slot](https://conecto.chat/tools/social/social_find_slot.md): The next free time to post on a channel, from its posting times and what is already scheduled. Free up to 1,000,000 reads a month. - [social_post](https://conecto.chat/tools/social/social_post.md): Posts now or at a set time to one or several channels, with pictures, video or a thread. $0.02 per channel posted to. - [social_confirm_post](https://conecto.chat/tools/social/social_confirm_post.md): Posts a TikTok post waiting for its owner with the choices they made in your chat, or drops it. Free. - [social_posts](https://conecto.chat/tools/social/social_posts.md): Posts in a time window (the last 7 days and the next 30 by default), each with its status and link. Free up to 1,000,000 reads a month. - [social_delete_post](https://conecto.chat/tools/social/social_delete_post.md): Deletes a post with its thread; one still waiting for its time never goes out and is refunded. Free. - [social_analytics](https://conecto.chat/tools/social/social_analytics.md): How a channel did over 7, 30 or 90 days, or how one published post did: each metric the network reports, by day. Free up to 1,000,000 reads a month. - [social_disconnect](https://conecto.chat/tools/social/social_disconnect.md): Removes a channel; its waiting posts are deleted, and refunded when their time had not come. Free.