Tools reference
Every tool a connected AI app can use in Social9, from reading your calendar to writing, scheduling and approving posts, with credit costs and permissions.
On this page
These are the actions an AI app can take in Social9. You never call them yourself: you ask in plain words, and the app picks the tool.
An app only sees the tools its permissions allow. See Permissions and test mode.
Reading your workspace#
Permission: See your brands and calendar.
| Tool | What it does |
|---|---|
whoami | Shows the workspace, who is signed in, the plan, the brands it can use, what it may do, the timezone, and whether test mode is on |
list_brands | Lists the brands it can use, with their connected accounts |
get_brand_profile | Reads a brand's voice, audience, offer, topics and words to avoid |
list_channels | Lists connected accounts and whether any need reconnecting |
list_posts | Finds posts by status, date or text |
get_calendar | Shows what is planned and posted, day by day, including empty days |
posts_on_day | Lists the posts already on a day, or up to 14 days (time, networks, accounts, first line, status), and the next free hour that day, 2 hours from posts on the same network |
list_approvals | Lists posts waiting in Approvals, with any flags |
get_analytics | Shows posts and their likes, comments, shares and clicks, for as many days back as your plan allows |
get_usage | Shows your plan, what is left this month (including bought credits and extra channels), and what each AI action costs. It can't buy anything |
get_best_times | Suggests the next good times to post, skipping times that already have a post |
weekly_review | Sums up the last 7 days and the next 7: what went out, what failed, what needs you |
get_brand_voice | Reads a brand's full voice settings and facts sheet |
brand_voice_check | Checks a post for avoided words, length limits, hashtags and links. Can also rewrite it in your voice (4 credits) |
Brands#
Permission: Create and edit brands.
| Tool | What it does |
|---|---|
create_brand | Creates a new brand with every detail you give it (website, description, audience, voice, offerings, hashtags, content pillars…). Counts toward your plan's brand limit. You then connect its accounts on the Channels page |
update_brand | Fills in or changes any brand detail. Send only what changes |
Posts#
Permission: Create and schedule posts, unless it says otherwise.
| Tool | What it does |
|---|---|
create_post | Saves a new post as a draft. Can set the options per network too, like a first comment, a Reel, a LinkedIn PDF or poll, or a YouTube title |
update_post | Changes a post that has not gone out yet, including its options per network |
schedule_post | Puts a post on the calendar at a time you agree, or the next good time. Can send it to Approvals instead |
bulk_schedule | Schedules several drafts at once, each at its own good time |
duplicate_post | Copies a post into a new draft |
delete_post | Deletes a draft or scheduled post. Posted posts cannot be deleted |
publish_now | Posts right away. Also needs Publish posts right away |
approve_post | Approves a post waiting in Approvals. Needs Approve or reject posts |
reject_post | Sends a post back to drafts with a reason. Needs Approve or reject posts |
Your own photos, videos and posts#
Permission: Create and schedule posts, unless it says otherwise.
| Tool | What it does |
|---|---|
upload_media_from_url | Copies an image or video from a public link into your media library |
create_upload_url | Gives the app a private link to upload a file you have |
finish_upload | Confirms an upload landed, and resumes a large one if parts are missing |
caption_media | Writes a caption in your brand voice for each file, with facts to check. Needs Use your AI credits (4 credits per caption) |
schedule_existing_media | Makes one post per file, as drafts, scheduled or for approval |
import_posts | Creates up to 200 posts in one go, from a list. Can check them first without creating anything |
Writing with AI#
Permission: Use your AI credits. These use the same credits as the dashboard. A post costs 4 credits.
| Tool | What it does |
|---|---|
suggest_what_to_post | Looks at your empty days, topics and recent posts, and suggests ideas with a day and time. Saves nothing (4 credits) |
generate_posts | Writes posts about a topic for one or more networks, saved as drafts |
plan_posts | Plans a week, 2 weeks or a month of posts from a link or a description. Also needs Create and schedule posts |
fill_calendar_gaps | Finds empty slots on each account and writes drafts for them, up to 30 at a time. Also needs Create and schedule posts |
adapt_for_networks | Turns one message into a version for each network (4 credits per network) |
repurpose_link | Reads a web page and writes one post per network about it (4 credits per network) |
generate_ideas | Writes 3 to 10 post ideas (6 by default) and saves them to the brand's Ideas board (4 credits per batch). Ask for ideas from your website or from your best posts, or a mix |
generate_image | Makes an image in your brand's style and saves it to your media library (10 credits, 20 for sharper) |
AI tools save drafts unless you ask for more. If credits run short, plan_posts writes as many as your credits allow.
Ideas, templates and Autopilot#
| Tool | What it does | Permission |
|---|---|---|
list_ideas | Shows the brand's Ideas board: each idea's title, notes, column, tags, angle and opening line. Can show one column or one tag | See your brands and calendar |
add_idea | Adds an idea you wrote to the board, with notes, tags and a column if you want. Free | Create and schedule posts |
update_idea | Edits an idea's title, notes or tags, or moves it to another column (Ideas, To do, In progress, Done) | Create and schedule posts |
delete_idea | Deletes one idea, only when you ask | Create and schedule posts |
get_templates | Shows the post templates written for the brand. If there are none yet, or you ask for a new set, it writes 12 (4 credits, also needs Use your AI credits) | See your brands and calendar |
get_autopilot | Shows the brand's Autopilot: mode, on or paused, posts per week for each account, weekly planning, brief, topics and safety rules | See your brands and calendar |
update_autopilot | Changes any of those Autopilot settings. Send only what changes. Modes stay within your plan, and only owners and admins can do it | Create and edit brands |
plan_week | Runs Plan my week now: Autopilot writes the coming week for each connected account. What happens next follows the Autopilot mode. Credits per post. Not available in test mode | Use your AI credits and Create and schedule posts |
Brand voice#
| Tool | What it does | Permission |
|---|---|---|
update_brand_voice | Changes a brand's voice settings, after checking with you. Not available in test mode | Create and edit brands |
Agencies#
| Tool | What it does | Permission |
|---|---|---|
share_link_create | Makes a client review link (no login) for chosen posts or a date range. Owners and admins. Not in test mode | Approve or reject posts |
report_create | Saves a report for some brands and a period | Create and edit brands |
report_link | Makes a live report link (add ?print=1 for a PDF). Owners and admins. Not in test mode | Create and edit brands |
best_times_get | Best weekday/hour slots for one account, from your own results | See your brands and calendar |
goals_get | Weekly posting goal, this week's count and streak per brand | See your brands and calendar |
Inbox, link in bio and competitors#
| Tool | What it does | Permission |
|---|---|---|
inbox_list | Lists comments, reviews and messages, or reads one conversation | See your brands and calendar |
inbox_reply | Replies publicly, or privately on Facebook/Instagram when messaging is on | Publish posts right away |
link_in_bio_get | Reads the brand's link-in-bio page and its clicks | See your brands and calendar |
link_in_bio_update | Creates or changes the link-in-bio page | Create and edit brands |
competitors_list | Followers, posts and engagement of tracked accounts | See your brands and calendar |
describe_image | Caption, hashtags and alt text from a photo (uses credits) | Use your AI credits |
Help docs#
These need no permission.
| Tool | What it does |
|---|---|
search_docs | Searches these help docs, so the app can answer "how do I…" questions from them |
read_doc | Reads one help docs page, so the app can guide you step by step and give you the link |
Queue and automation#
Permission: Create and schedule posts (the list tools need only See your brands and calendar). Times are in the brand's timezone (its own, else the workspace's).
| Tool | What it does |
|---|---|
queue_slots_get | Shows the brand's weekly posting times (Queue → Posting times), and any per-account times |
queue_slots_set | Replaces the brand's (or one account's) weekly posting times |
queue_add | Puts a draft, or a new post, into the next free posting time |
channel_groups_list | Lists the brand's channel groups (Queue → Channel groups): saved sets of accounts to post to together |
recycling_categories_list | Lists the brand's repost collections (Reposts), their schedule and how many posts they hold |
recycling_categories_create | Creates a repost collection with its schedule and posts (not in test mode) |
feeds_list | Lists the blogs, news sites and YouTube channels on Blog to posts |
feeds_add | Adds a blog or YouTube channel to Blog to posts; new articles and videos become drafts or queued posts (not in test mode) |
Ready-made prompts#
Some apps show these as shortcuts:
| Prompt | What it does |
|---|---|
| plan_my_week | Looks at the calendar, finds the gaps and plans this week's posts as drafts |
| turn_link_into_posts | Reads a page and writes one post per connected network, saved as drafts |
Limits#
- Plan limits and credits are the same as in the dashboard. When a limit is hit, the app gets a plain message and an upgrade link. Limits are checked before anything changes. When scheduling many posts at once, it stops at the limit and keeps the rest as drafts.
- Each connection can make up to 120 requests a minute, and up to 20 AI requests a minute.