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
| 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, message settings 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, posts, messages, links, opening DM, public replies, asks, reminder or name |
duplicate_automation | manage | Copy an automation as a draft, optionally with a new name |
delete_automation | manage | Delete an automation, after a preview |
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. 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.
postacceptslatest, a post or reel link, a media id,any(every post, Pro) ornext(your next post, Pro).poststakes several specific posts (Pro).messageis the DM that carries the link.opening_dmis 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_repliestakes up to 10 replies; one is picked at random for each comment.linkstakes up to 3 buttons (more than one is Pro).link_as_textwrites the link into the message instead of a button (Instagram).ask_for_follow(Instagram),ask_for_email,ask_for_phoneandfollow_up(a reminder after 30 minutes to 20 hours) are Pro and need the opening DM on.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 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.