Reachlee DocsTools 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
| Tool | Permission | What it does |
|---|---|---|
list_accounts | read | Your workspaces and connected accounts with plan, status and latest follower count |
get_overview | read | DMs sent, comments replied, link clicks, reply rate and follower change for a range |
rank_posts | read | Posts and reels ranked by CTR, DMs, clicks, people or comments |
rank_automations | read | Automations ranked by performance with the top skip reason |
list_automations | read | All automations with status, trigger, keywords, posts and lifetime stats |
get_automation | read | One automation in full with 14-day insights |
create_automation | manage | Create a comment-to-DM automation on an account |
update_automation | manage | Change keywords, messages, link, public reply, posts or name |
set_automation_status | manage | Pause or resume an automation |
retrigger | manage | DM people who commented before the automation existed |
list_conversations | read | Recent DM threads with filters |
get_conversation | read | Read one thread, with the 24-hour window status |
reply_to_conversation | send | Reply inside an open thread, after a preview |
list_leads | read | Contacts who shared an email or phone |
Common inputs
- range —
24h,7d(default),30d,90d,mtd(this month) orall. 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,peopleorcomments.
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.
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 messages, links, keywords, posts, lifetime stats and 14-day insights.
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 or through the Google Sheets integration.
Managing
create_automation
Inputs: account, post, keywords, message, link_url, link_label, opening_message, opening_button, public_reply, ask_for_follow, name, publish.
postacceptslatest, an Instagram post or reel link, a media id,any(every post, Pro) ornext(your next post, Pro).messageis the DM that carries the link. Withlink_urlset, people first get an opening DM with a button, then the link.publishdefaults 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 keywords, message, opening_message, link_url, link_label, public_reply (pass an empty string to turn it off), media_ids (full replacement list) and name. Only the fields you pass change.
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; Reachlee paces the sends within Instagram's limits.
Sending
reply_to_conversation
Inputs: conversation_id, message, confirm. Works only while Instagram's 24-hour window is open for that person. 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.