Reachlee Docs

Tools reference

Every tool the Reachlee AI connector exposes, what it does, the permission it needs and its inputs.

Your assistant chooses tools from this list based on what you ask. You never call them by name, but knowing what exists helps you ask for the right thing. Each tool needs one of three permissions you grant at sign-in: read, manage or send.

At a glance

ToolPermissionWhat it does
list_accountsreadYour workspaces and connected accounts with plan, status and latest follower count
get_overviewreadDMs sent, comments replied, link clicks, reply rate and follower change for a range
rank_postsreadPosts and reels ranked by CTR, DMs, clicks, people or comments
rank_automationsreadAutomations ranked by performance with the top skip reason
list_automationsreadAll automations with status, trigger, keywords, posts, message settings and lifetime stats
get_automationreadOne automation in full with 14-day insights
create_automationmanageCreate a comment-to-DM automation on an account
update_automationmanageChange keywords, posts, messages, links, opening DM, public replies, asks, reminder or name
duplicate_automationmanageCopy an automation as a draft, optionally with a new name
delete_automationmanageDelete an automation, after a preview
set_automation_statusmanagePause or resume an automation
retriggermanageDM people who commented before the automation existed
list_conversationsreadRecent DM threads with filters
get_conversationreadRead one thread, with the 24-hour window status
reply_to_conversationsendReply inside an open thread, after a preview
list_leadsreadContacts who shared an email or phone

Common inputs

  • range — 24h, 7d (default), 30d, 90d, mtd (this month) or all. Free workspaces are capped at 30 days.
  • account — @handle, the display name or the id. Omit it to cover every account you can see. With exactly one connected account it is implied.
  • metric — ctr (default), dms, clicks, people or comments.

CTR everywhere in Reachlee means unique people who clicked divided by unique people who entered the flow, so one person tapping three times still counts once. With Direct links on (Settings, Pro and above) clicks aren't recorded, so tools report them as not tracked rather than zero.

Keywords ignore case, and a keyword must start a word in the comment: LIGHT fires on "love the light" and "lighting", but not on "highlight". A keyword with several words must appear as written. No keywords means every comment on the post.

Reading

list_accounts

No inputs. Returns each workspace with its plan, your role, and each connected account with channel, status and followers with the 30-day change. Ask it first when you have several accounts so the assistant can name them.

get_overview

Inputs: range, account. Headline numbers for the whole workspace and per account. Example: "How did I do in the last 30 days?"

rank_posts

Inputs: range, metric, account, limit (1 to 25, default 10). Each row has the post caption and link, people reached, comments replied, DMs sent, clicks, unique clickers and CTR, plus which automations fired on it. Posts with fewer than three people are left out of CTR rankings. Per-post data exists from 2 October 2026.

rank_automations

Inputs: range, metric, account, limit (1 to 50). Adds triggers, succeeded and skipped counts and the most common skip reason, which is the fastest way to answer "why is this one not sending".

list_automations and get_automation

list_automations takes account and status (live, paused, draft). get_automation takes automation_id and returns the keywords, posts, whether the opening DM is on, the messages and links, every public reply, any follow, email or phone ask and the reminder, plus lifetime stats and 14-day insights. Canvas flows show their triggers; their steps are edited on the canvas.

list_conversations and get_conversation

list_conversations takes account, unread_only, since_hours, search and limit (up to 50). get_conversation takes conversation_id and limit and tells you whether the 24-hour reply window is open and until when.

list_leads

Inputs: account, search, limit (up to 100), offset. Returns handle, name, email, phone, account and last activity. Export happens in Reachlee under Contacts (Pro and above) or through the Google Sheets integration (Business).

Managing

create_automation

Inputs: account, post or posts, keywords, message, link_url and link_label or links, link_as_text, opening_dm, opening_message, opening_button, public_reply or public_replies, ask_for_follow, ask_for_email, ask_for_phone, follow_up, name, publish.

  • post accepts latest, a post or reel link, a media id, any (every post, Pro) or next (your next post, Pro). posts takes several specific posts (Pro).
  • message is the DM that carries the link. opening_dm is the builder's opening-DM switch: on (default), people first get an opening DM with a button, then the link; off, the link DM goes out straight away.
  • public_replies takes up to 10 replies; one is picked at random for each comment.
  • links takes up to 3 buttons (more than one is Pro). link_as_text writes the link into the message instead of a button (Instagram).
  • ask_for_follow (Instagram), ask_for_email, ask_for_phone and follow_up (a reminder after 30 minutes to 20 hours) are Pro and need the opening DM on.
  • publish defaults to true. Pass false to save a draft.

Pro-only options such as any-post, several posts or ask-for-follow return a clear error on Free, exactly like the builder.

update_automation

Inputs: automation_id plus any of the create options above (except post, posts and publish), media_ids (full replacement list of posts) and name. Only the fields you pass change. public_replies: [] or public_reply: "" turns public replies off. Canvas flows can only be renamed here.

duplicate_automation

Inputs: automation_id, name. Copies everything as a new draft on the same account. Change its keywords, posts or link with update_automation, then set it live.

delete_automation

Inputs: automation_id, confirm. The first call says what would be deleted; it's deleted only on a second call with confirm after you agree. It can't be undone; past runs and contacts stay.

set_automation_status

Inputs: automation_id, status (live or paused). Resuming a draft publishes it.

retrigger

Inputs: automation_id, confirm. The first call previews how many past commenters are eligible. Nothing is sent until the assistant calls it again with confirm after you agree. Pro feature. It reaches comments from the last 7 days, at most 200 new people per account per day, and Reachlee paces the sends within Meta's limits.

Sending

reply_to_conversation

Inputs: conversation_id, message, confirm. Works only while the 24-hour window is open for that person, on Instagram or Messenger. The first call returns a preview with the recipient, the message and when the window closes; the reply is sent only on a second call with confirm. There is no tool to message someone who has not written first.

On this page