What a skill is
A skill reads the account and makes the changes the customer asked for; changes that matter wait for the customer's yes (see Tools).
An automation runs the same fixed steps every time it is triggered. A skill is for work that needs judgment, or several tools in a row, where the next step depends on what the last one returned. If a job can be written as fixed steps, build it as an automation instead.
Tools
These are the tools a skill can use. Some need a plan, add-on or role on the account (for example the AI features, Timekeeper, or an agency manager); a tool that does not apply answers so. Each tool is marked Read if it looks at the account, or Write if it can change data, send something or spend money.
Write tools marked Needs yes are gated by the server. Without confirm "yes" the call is refused and nothing changes. The first call returns a preview of the change; the skill shows it to the customer and calls again with confirm "yes" only if they agree. update_form_settings and update_saved_survey need this only when the form or survey is on a published page.
Write tools marked Ask first: the skill asks the customer before it calls them.
Write tools with no second mark have no confirm step and run when the customer asks for them. The propose_ tools create a proposal that the host approves in the LeedAgent app, so nothing changes until the host approves it. The propose_ads tools work the same way, except pausing and updating an ad: those always wait for approval in the app, even after the customer's yes in this chat. A new paused campaign draft and turning an ad back on run at once with the customer's yes; without it they wait for approval in the app.
AI employees and AI Desk
activate_Write Needs yes: Turns on a Conversation AI campaign on this account, so its messages go out to customers right away; ask the user to confirm by typing yes before calling, and confirm must be "yes".conversation_ ai_ campaign add_Write Needs yes: Adds one contact, by its UUID, to a Conversation AI reactivation campaign's recipient list.conversation_ ai_ campaign_ recipient approve_Write Needs yes: Approves a compliance review that is waiting for a decision, when it is not part of an ad build.compliance_ review cancel_Write: Cancels one AI Desk approval card that is still waiting for a decision, like the card's Cancel button; its action does not run, and cards that already ran, were cancelled or expired are refused.ai_ desk_ approval cancel_Write Needs yes: Cancel one of your Conversation AI reactivation campaigns.conversation_ ai_ campaign create_Write: Creates a Conversation AI campaign as a draft, which you can review before you activate it.ai_ conversation_ campaign_ draft create_Write: Creates a disabled Conversation AI profile draft, which never turns messaging on; the account needs the AI features, and the tone must be one of friendly_professional, warm_conversational, direct_efficient, calm_helpful or polished_agent.conversation_ ai_ profile_ draft delete_Write Needs yes: Deletes a Conversation AI profile and its configuration, so it is no longer live; ask the user to confirm by typing yes before calling, and confirm must be "yes".conversation_ ai_ profile disable_Write: Turns off a Conversation AI profile on this account right away; a profile that is already off is refused, and the account needs the AI features.conversation_ ai_ profile duplicate_Write: Copies a Conversation AI profile on this account into a new disabled draft; the account needs the AI features.conversation_ ai_ profile_ draft enable_Write Needs yes: Turn on auto-reply for your Conversation AI profile, so it answers inbound messages automatically.conversation_ ai_ auto_ reply enable_Write Needs yes: Turns on a Conversation AI profile, so its prompt and settings are used for live customer replies; ask the user to confirm by typing yes before calling, and confirm must be "yes".conversation_ ai_ profile generate_Write Needs yes: Generates image files for creative use, charged to the account's wallet.creative_ images generate_Write Needs yes: Generate a creative package (headlines, body and assets) from a brief.creative_ package get_Read: The AI Desk operating documents (how-to guides the AI Desk follows, e.g. meta-campaigns, landing-pages).ai_ desk_ document get_Read: The full working notes the AI Desk keeps for this client (preferences, decisions, progress), oldest first.ai_ desk_ notes get_Read: Returns the health of the AI employees on this account.ai_ employee_ health get_Read: Returns the broken or expired connections on this account (Meta ads, Meta posting, Google, YouTube, Zoho Meeting), each with its kind, label, state, reason and reconnect path. An empty list means every checked connection works. Meta posting and YouTube rows are only for the platform owner account; customer accounts never get them.connection_ health get_Read: Returns one Conversation AI campaign on this account; the account needs the AI features, and campaigns from other accounts are not found.conversation_ ai_ campaign get_Read: Returns one Conversation AI profile on this account; the account needs the AI features, and profiles from other accounts are not found.conversation_ ai_ profile get_Read: Read Conversation AI session health. Optional days (7, 30 or 90) also counts handed-off and qualified sessions in that window.conversation_ ai_ session_ health get_Read: Returns the official LeedAgent how-to videos: title, YouTube ID, the in-app video file and a watch link; pass feature_key for one feature (automations, pipelines, websites, google_sheet_import, community_host or member_ai), and lang (en, es or pt) sets the language.feature_ videos list_Read: Lists the proposals the AI employees have made.ai_ employee_ proposals list_Read: Read Conversation AI campaigns.conversation_ ai_ campaigns list_Read: Lists your Conversation AI conversations: contact, last message and status (answering, handed off or done). Filter by status or profile, 25 rows per page by default, up to 100.conversation_ ai_ conversations list_Read: Read Conversation AI profiles.conversation_ ai_ profiles pause_Write: Pauses an active Conversation AI campaign on this account right away; a campaign that is not active is refused, and the account needs the AI features.conversation_ ai_ campaign plan_Write Ask first: Plan creative assets from a brief: a draft asset plan only.creative_ assets preview_Write: Shows who a Conversation AI campaign would reach; it uses no AI credit, and the account needs the AI features.conversation_ ai_ campaign remove_Write Needs yes: Removes one contact that is still waiting to be messaged, by its UUID, from a Conversation AI reactivation campaign's recipient list.conversation_ ai_ campaign_ recipient run_Write Ask first: Runs a compliance review on a piece of content, using AI credit; it can flag the content for action, and for an ad, pass headline, primary_text and destination_url so the ad build can match the review. Outside Launch my ads, the skill asks the customer before it runs.compliance_ review simulate_Write: Tests a Conversation AI profile in a sandbox: the model answers, but no CRM or runtime rows are saved; it uses AI credit, and the account needs the AI features.conversation_ ai_ profile update_Write: Changes a draft AI lead qualifier profile.ai_ lead_ qualifier_ profile_ draft update_Write: Update only a disabled Conversation AI profile draft.conversation_ ai_ profile_ draft update_Write Needs yes: Updates an enabled Conversation AI profile; the valid fields you send go live at once for customer replies, and ask the user to confirm by typing yes before calling, and confirm must be "yes".live_ conversation_ ai_ profile
Account and settings
add_Write Needs yes: Add a root domain record to your agency.root_ domain api_Read: Returns the schema of the LeedAgent API.schema check_Read: Check whether one fully-qualified domain is available to buy, and its price.domain_ availability check_Read: Check whether a LeedAgent subdomain name is still free to take.subdomain_ availability clear_Write Needs yes: Remove your custom app logo and go back to the default branding.app_ logo configure_Write Needs yes: Set a white-label app domain (dashboard login) on a verified root domain.app_ domain configure_Write Needs yes: Set up email sending for a root domain through the platform email service.domain_ email configure_Write Needs yes: Put one of your sites on a subdomain of a root domain (empty subdomain is the root address).domain_ website create_Write Needs yes: Submit a new feature request or bug report to LeedAgent.feature_ request create_Write Needs yes: Create a new LeedAgent subdomain on your account (your first one becomes primary).subdomain delete_Write Needs yes: Delete every browser push subscription on your account, so browser push notifications stop.all_ browser_ push_ subscriptions delete_Write Needs yes: Delete a root domain and its configuration.root_ domain delete_Write Needs yes: Delete one of your subdomains.subdomain disconnect_Write Needs yes: Stop serving a site on one of your custom addresses.domain_ website disconnect_Write Needs yes: Disconnect the Meta Ads account connection.meta_ ads get_Read: Read your account security status: whether a password is set, two-factor authentication state and the sign-in options.account_ security get_Read: Read the consent page config (logo, custom ACA and Medicare disclosure text) and list signed consent records.consent_ settings get_Read: Returns the features this account can use, its limits, and whether it is running in a reduced (degraded) state.entitlements get_Read: One feature request or bug report by id.feature_ request get_Read: Read the Google Sheet lead import config: enabled, sheet_url, source_name, field_mapping and sync status.google_ sheet_ import get_Read: Full detail of one of your own invoices by invoice_id (from your billing history).invoice get_Read: Read the status of your lead-import connections: the Google Sheet import and the Meta Lead Ads import.lead_ import_ connections get_Read: Returns connect_url, a link to Settings, then Connections, where the user presses Connect Meta. It takes no input. Nothing is connected until the user presses Connect Meta there.meta_ connect_ url get_Read: Read the Meta Lead Ads import config: enabled, source_name, webhook URL and timestamps.meta_ lead_ import get_Read: Returns the profile settings.profile_ settings get_Read: Get the details of one root domain by its domain_id, including its websites, email and app domains.root_ domain get_Read: Your plan's subdomain limits: max allowed, how many you have, whether you can rename them, white-label, and whether you can create another.subdomain_ plan_ info get_Read: Return the account's compact current plan and subscription status.subscription get_Read: Return used and allowed quantities for the account's subscription resources.subscription_ usage get_Read: Read the team lead settings: lead access mode (shared or assigned), the pipeline distribution rules and weights, the members and the pipelines.team_ lead_ settings get_Read: Returns a summary of the team.team_ summary get_Read: Return the account wallet's available balance and currency.wallet healthRead: Returns a health check of the service.invite_Write Needs yes: Invite a new team member to your account by email, as admin or member (default member).team_ member list_Read: List the LeedAgent subdomains allocated to your account, with the plan limits and whether you can create another.account_ subdomains list_Read: Lists the client accounts under your agency.agency_ clients list_Read: List your account's LeedAgent subdomains (primary first).agency_ subdomains list_Read: List the browser push subscriptions on your account with their status.browser_ push_ subscriptions list_Read: List your white-label custom domains with verification and email status.custom_ domains list_Read: List contacts with a do-not-disturb (opt-out) block on any channel.dnd_ contacts list_Read: List LeedAgent feature requests and bug reports, optionally filtered by type, category or status, sorted newest, oldest or top.feature_ requests list_Read: Clients invited to the Client Portal: status, invited date and last sign-in.portal_ access list_Read: List the root domains on file for your agency, with their verification status.root_ domains list_Read: List the Meta pixels saved on your account: id, name, pixel_id, stored and usable.saved_ pixels list_Read: List compact wallet ledger entries with optional server-side date filters.wallet_ ledger reactivate_Write Needs yes: Reactivate a suspended client account of your agency.agency_ client remove_Write Needs yes: Remove a team member's access to your account.team_ member rename_Write Needs yes: Rename one of your subdomains (id from list_agency_subdomains).subdomain resend_Write Needs yes: Resend the sign-up invite email to one of your agency's clients who has never signed in (client_id from list_agency_clients). At most once per client per hour.agency_ client_ invite revoke_Write Needs yes: Revoke a pending team invitation by its invitation id.team_ invitation rotate_Write Needs yes: Rotate the Meta Lead Ads webhook secret.meta_ lead_ import_ token search_Read: Search the domain registrar for domains available to buy.domains_ for_ purchase set_Write Needs yes: Set your app logo to an image from your own media library (media_id).app_ logo_ from_ media set_Write Needs yes: Block or clear do-not-disturb for one contact on one channel (sms, whatsapp, email or voice). is_dnd true blocks, false clears.contact_ dnd set_Write Needs yes: Set the Meta business that an existing Meta connection works with.meta_ business_ scope set_Write Needs yes: Make one of your subdomains the account's primary one.primary_ subdomain suspend_Write Needs yes: Suspend one of your agency's client accounts (client_id from list_agency_clients).agency_ client sync_Write Needs yes: Run a manual Google Sheet import now.google_ sheet_ import update_Write Needs yes: Update your business profile (name, industry, contact email and phone, website, company type, address, logo, operating hours, reviews).business_ profile update_Write Needs yes: Change the consent page logo or custom ACA and Medicare disclosure text, in English, Spanish or Portuguese.consent_ settings update_Write Needs yes: Edit a feature request you submitted (title, description, category, page_path, error_message).feature_ request update_Write Needs yes: Change the Google Sheet lead import config (enabled, sheet_url, source_name, field_mapping).google_ sheet_ import update_Write Needs yes: Change the Meta Lead Ads import config (enabled, source_name).meta_ lead_ import update_Write: Changes your profile preferences.profile_ preferences update_Write Needs yes: Change the team lead access mode (shared or assigned) and the pipeline distribution rules. Shared needs Community 197 or up; on a lower plan the change is refused with the shared_leads_locked error (403) and nothing is saved.team_ lead_ settings update_Write Needs yes: Change a team member's role to admin or member.team_ member_ role verify_Write Needs yes: Verify the DNS of a white-label app domain and create its secure proxy host, which enables HTTPS and production app serving.app_ domain verify_Write Needs yes: Check the email DNS records of a root domain through the platform email service.domain_ email verify_Write Needs yes: Verify the DNS of a website subdomain and create its secure proxy host, which enables HTTPS.domain_ website vote_Write Needs yes: Vote up or down on a feature request, or none to remove your vote.feature_ request
Ads
configure_Write Needs yes: Choose which Meta business and connection the ads manager uses.ads_ business_ scope create_Write Ask first: Save a new AI optimisation recommendation for one Meta ad account (ad_account_id like act_123) as a local record.ads_ recommendation disconnect_Write Needs yes: Disconnect one Meta ads connection (connection_id) from your account.ads_ connection duplicate_Write Needs yes: Duplicate one stored campaign, ad set or ad on your Meta ad account; the copy is created PAUSED. ad_account_id is the Meta ad account id like act_123.ads_ object get_Read: Ads Conversions API status.ads_ capi_ status get_Read: Ads compliance status per campaign, each with a short compliance_employee summary (status, issues, required action).ads_ compliance get_Read: Shows whether the ads account is connected.ads_ connection_ status get_Read: Read the conversion-leads setup for your ads: whether it is on, its dataset and event rules.ads_ conversion_ leads get_Read: Shows the ads totals; pass ad_account_id (it starts with act_) to pick an ad account, otherwise the connected account synced most recently is used and the reply names it.ads_ overview get_Read: Read the AI ads preferences for one Meta ad account (ad_account_id like act_123): score profile, guardrails and campaign rules.ads_ preferences get_Read: Read one Ads Manager project by its id, including its messages.ads_ project get_Read: Get one AI optimisation recommendation by its numeric id, with its evidence and proposed change.ads_ recommendation get_Read: Status of the $300 done-for-you Facebook campaign setup offer: whether the account can order, any open order and its vertical, price and the conditions.campaign_ setup_ status import_Write Ask first: Import the leads from one Meta instant form into your CRM. ad_account_id is the Meta ad account id like act_123.ads_ form_ leads list_Read: List the usable Meta assets for one ad account (ad_account_id like act_123): pages, lead forms, images, videos, audiences, pixels and catalogs.ads_ assets list_Read: List stored Meta ads breakdown rows for one ad account (ad_account_id like act_123), by campaign, ad set or ad.ads_ breakdowns list_Read: Campaigns with spend, impressions, clicks, leads, lead_action_type, cost_per_lead (spend / leads, null withads_ campaigns list_Read: List the conversion-leads pipelines on your account, with their ids and settings.ads_ conversion_ leads_ pipelines list_Read: List stored hour-of-day Meta ads insight rows for one ad account (ad_account_id like act_123), by campaign, ad set or ad.ads_ hourly_ insights list_Read: Lists ad insights from date_start to date_end (both required, YYYY-MM-DD); group day (the default) gives one row per stored day, and group total gives one row for the whole range per campaign, ad set or ad, where level picks which of those to list; ad_account_id picks one ad account.ads_ insights list_Read: List the stored market intel: Meta Ad Library ads by traffic source, vertical, active flag, page or query.ads_ market_ intel list_Read: Lists this member's pending approval proposals.ads_ pending_ approvals list_Read: List the recommendations LeedAgent's AI recorded for one Meta ad account (ad_account_id like act_123), newest first.ads_ recommendations propose_Write: Proposes pausing an ad. It always waits for approval in the app, even after the customer's yes in this chat.ads_ pause propose_Write: Proposes building a new ad campaign in a paused state, which spends nothing until it is turned on; without the customer's yes in this chat it waits for approval in the app; with it, the change runs at once, and turning the campaign on is a separate yes.ads_ paused_ draft propose_Write: Proposes turning an ad back on; without the customer's yes in this chat it waits for approval in the app; with it, the change runs at once.ads_ resume propose_Write: Proposes a change to an ad. It always waits for approval in the app, even after the customer's yes in this chat.ads_ update queue_Write Ask first: Queue a media sync for one ad account so its ad creative media is refreshed from Meta. ad_account_id is the Meta ad account id like act_123.ads_ media_ sync queue_Write: Queue a Meta Ads sync.ads_ sync search_Read: Search Meta targeting options: type adgeolocation for locations or adinterest for interests, with q as the search text.ads_ targeting send_Write Needs yes: Send a test lead event with a test event code, to check the conversion-leads setup.ads_ conversion_ leads_ test subscribe_Write Needs yes: Subscribe a Facebook page to lead capture so its lead forms send leads to your CRM. ad_account_id is the Meta ad account id like act_123.ads_ lead_ capture update_Write Needs yes: Change the conversion-leads setup: turn it on or off, its dataset, lead event source and event rules.ads_ conversion_ leads update_Write Needs yes: Change one conversion-leads pipeline by its pipeline_id.ads_ conversion_ leads_ pipeline update_Write Needs yes: Change the name or budget of a draft campaign or ad set on your Meta ad account.ads_ draft_ object update_Write Needs yes: Change the AI ads preferences for one Meta ad account (ad_account_id like act_123).ads_ preferences
Analytics
create_Write Needs yes: Create a conversion goal that counts a visitor event.conversion_ goal delete_Write Needs yes: Permanently delete one conversion goal.conversion_ goal export_Write Needs yes: Prepare a CSV export of the analytics for one site or one page, and return a download link; ask the user to confirm by typing yes before calling, and confirm must be "yes".analytics_ csv get_Read: Returns an analytics report: kind is dashboard (the default) or site, and date_from, date_to and site_id narrow it.analytics_ report get_Read: Per-goal conversion statistics for one site or one page.conversion_ goal_ stats get_Read: Returns a CRM analytics summary for the last days (default 30, up to 365). Add range_preset (this_week, this_month, last_30_days or custom) to also get leads, leads by source and lead-to-won conversion for that range; custom needs start and end (YYYY-MM-DD).crm_ analytics_ summary get_Read: Link click analytics for one site or one page; with neither, all your sites. Give community_id (from list_my_communities) instead for one community you host: the same rows as Analytics > Links with that community picked. days (1-365) sets the window; a community defaults to 30.link_ click_ analytics get_Read: Realtime visitor analytics for one site or one page; with neither, all your sites.realtime_ analytics get_Read: Site or page reporting: visits and engagement for one site or one page.site_ page_ analytics list_Read: List your conversion goals with their type, target and active state.conversion_ goals toggle_Write Needs yes: Switch one conversion goal active or inactive.conversion_ goal update_Write Needs yes: Change the name, type, target or event of one conversion goal.conversion_ goal
Automations
archive_Write Needs yes: Archives one workflow on this account.workflow bulk_Write Ask first: Enroll every contact matching a filter in a workflow. workflow_id comes from the automation workflow list.enroll_ contacts create_Write: Creates a workflow as a draft; its status is always set to draft, so this call never publishes it. The payload has a name, a trigger (or a list of triggers) and a list of steps. Each step has a step_key, a step_type, a config and a next, which is the step_key it leads to; for a branch, next is a map of branch label to step_key. Call get_workflow_schema first for the valid trigger types, step types and each step's config.workflow_ draft create_Write: Creates a workflow folder, optionally inside a parent folder.workflow_ folder create_Write: Creates a workflow from one of the ready-made templates on this account, as a draft; its status is always set to draft, so this call never publishes it. If a workflow with the same name already exists, the call is refused; it requires the automation feature.workflow_ from_ kit_ template delete_Write Needs yes: Deletes one workflow on this account.workflow delete_Write Needs yes: Delete a workflow folder.workflow_ folder enroll_Write Needs yes: Enrolls one contact in a published workflow; a contact who is already enrolled stays enrolled, so repeating the call is safe.contact_ in_ workflow exit_Write Needs yes: Exit one workflow enrollment so its contact leaves the workflow.workflow_ enrollment get_Read: Without a workflow_id, returns only the trigger and step catalog, so read it before you create a draft. With a workflow_id, returns that workflow's definition and the automation schema it can use; it requires the automation feature.workflow_ schema list_Read: Lists workflow enrollments; filter by workflow, contact or status, and it requires the automation feature.workflow_ enrollments list_Read: Lists the workflow folders on this account; it requires the automation feature.workflow_ folders list_Read: Lists the ready-made workflow templates this account can start from, with each one's name, description, trigger and number of steps; it requires the automation feature.workflow_ kit_ templates list_Read: Lists workflow runs, filtered by status and date; it requires the automation feature.workflow_ runs list_Read: Lists workflows, filtered by name, trigger or status; it requires the automation feature.workflows move_Write: Move a workflow into a folder.workflow_ to_ folder pause_Write Needs yes: Pauses a published workflow; its automation stops for customers until it is resumed.workflow pause_Write Needs yes: Pause one workflow enrollment so its contact stops advancing.workflow_ enrollment preview_Read: Shows how many contacts a filter would enroll in a workflow and returns a preview_token; run this before bulk_enroll_contacts, and get workflow_id from the workflow list.bulk_ enroll publish_Write Needs yes: Publishes a workflow, which can start automation that messages customers.workflow reenroll_Write Needs yes: Re-enroll a contact from one workflow enrollment so it runs the workflow again.workflow_ enrollment resume_Write Needs yes: Resumes a paused workflow; this restarts automation that messages customers.workflow resume_Write Needs yes: Resume one paused workflow enrollment.workflow_ enrollment run_Write Needs yes: Run the workflow steps that are due for enrolled contacts now, up to limit enrollments.due_ workflow_ enrollments stop_Write Needs yes: Stops one contact's enrollment in a workflow, which ends that contact's automation.workflow_ enrollment test_Write Needs yes: Run a live test of a workflow for one real contact.workflow test_Write Needs yes: Send a real test message from one Send Message step.workflow_ message_ step test_Write Needs yes: Send a test request from a webhook step to a URL, with a test payload.workflow_ webhook update_Write Needs yes: Edit a published workflow's name, description, trigger, triggers or steps.published_ workflow update_Write: Changes a draft workflow; published workflows cannot be changed with this call.workflow_ draft update_Write: Renames, moves or reorders a workflow folder; set clear_parent to true to move it to the top level.workflow_ folder
Calendar
cancel_Write Needs yes: Cancels an appointment.appointment complete_Write Needs yes: Marks an appointment as completed.appointment confirm_Write Needs yes: Confirms an appointment that needs confirming; to decline it, cancel it instead.appointment create_Write Needs yes: Books an appointment for a contact and sends the calendar notifications.appointment create_Write: Create an appointment type (a bookable meeting type) on your calendar. name is required.appointment_ type create_Write: Create a booking link for one appointment type. The result includes its embed snippets (Inline, Popup button, Popup text).booking_ link create_Write: Creates a calendar group on this account.calendar_ group create_Write: Create (or find) the CRM contact for one of your booked appointments and link the appointment to it.contact_ from_ appointment create_Write: Create a one-time link for one booking link that stops working after expiry_minutes (5 to 20160, default 1440).one_ time_ booking_ link deactivate_Write Needs yes: Deactivate one of your appointment types by its id, so no new bookings of it are taken.appointment_ type delete_Write Needs yes: Deletes one booking link; ask the user to confirm first, then repeat the call with confirm set to "yes".booking_ link delete_Write Needs yes: Deletes one calendar group; its booking links are kept but become ungrouped, and ask the user to confirm first, then repeat the call with confirm set to "yes".calendar_ group get_Read: Returns one appointment.appointment get_Read: Returns availability for booking.availability get_Read: Returns the open calendar slots for one appointment type, over at most 60 days.available_ calendar_ slots get_Read: One booking link with its slug, appointment type, group, active state and embed snippets (Inline, Popup button, Popup text).booking_ link get_Read: The embed codes for one booking link: the Inline, Popup button and Popup text snippets, the Iframe code, and the public URL.booking_ link_ embed get_Read: Read your calendar preferences: week start days, the widget language and time format, and whether bookings create CRM contacts.calendar_ preferences list_Read: Lists the appointment types.appointment_ types list_Read: Lists appointments.appointments list_Read: Lists booking links.booking_ links list_Read: Lists the calendar groups; pass query to filter by name.calendar_ groups mark_Write Needs yes: Marks an appointment as a no-show.appointment_ no_ show reschedule_Write Needs yes: Moves an appointment to a new time and updates the notifications the customer gets.appointment set_Write: Sets the questions a guest answers on the booking page of one appointment type, by its id. Up to 10 questions, each with a label, a type (short text, long text, choice or checkbox) and a required flag; choice questions take 2 to 20 choices. A new list replaces all the questions, and an empty list removes them.appointment_ type_ questions update_Write: Update one of your appointment types by its id (get ids from your calendar).appointment_ type update_Write: Changes one booking link; send only the fields you want to change, group_id sets its calendar group, and an empty string takes the link out of its group; read the link first to see its current values.booking_ link update_Write: Update your bookable calendar availability: timezone, the weekly schedule object and the date exceptions list.calendar_ availability update_Write: Renames a calendar group.calendar_ group update_Write: Changes your calendar preferences.calendar_ preferences
Communities
community.Write Needs yes: Post one Question card now in a community the host owns. Members answer it with ordinary replies. Nothing is posted until the host approves.questions. create community.Write Needs yes: Schedule a series of 1 to 30 Question posts, one per day or one per week, from a start date and time in the host's time zone. Nothing is posted until the host approves.questions. schedule community.Read: Read a community's name, description, and the questions already asked or queued, to draft new Question posts. Saves nothing.questions. suggest community.Write Needs yes: Cancel a scheduled post that has not published yet. A cancelled post is never published.scheduled_ posts. cancel community.Write Needs yes: Schedule one post in a community the host owns. It publishes at the local time given, in the host's time zone. Nothing is posted until the host approves.scheduled_ posts. create community.Read: List the scheduled posts and Question posts of a community the host owns, soonest first, with each publish time in the host's time zone and any failure reason.scheduled_ posts. list community.Write Needs yes: Change the text or time of a scheduled post that has not published yet. Send only the fields to change.scheduled_ posts. update add_Write: Add an image to an unpublished lesson draft.lesson_ image arrange_Write Needs yes: Set the section, section order and position of lessons in one of your communities, in one call.community_ lessons create_Write: Create an unpublished lesson draft.lesson_ draft get_Read: Read the group chat settings for one community.community_ chat_ settings get_Read: Read one owned community lesson including its body, but without private image identifiers or signed image URLs.community_ lesson get_Read: Read whether members of an owned community can message each other directly (messages between members).community_ message_ settings get_Read: Read one page of a member to host direct message thread.community_ message_ thread get_Read: Return the host analytics overview for an owned community.community_ overview get_Read: Read an owned community's page fields, categories and badges.community_ page get_Read: Returns your community's main price, billing interval, currency and yearly price, plus the join funnel for the last 30 days: joins started, checkouts started, paid, free joins, pending approval, still deciding and did not finish.community_ pricing get_Read: Read the welcome message of an owned community: on/off, the text, who sends it and who can.community_ welcome_ message give_Write Needs yes: Send a short thank-you note (kudos) to one member of a community. The first call returns a preview.community_ kudos list_Read: List the badges of one of your communities, with how many members each has been awarded.community_ badges list_Read: List the post categories of one of your communities, in their display order.community_ categories list_Read: Read one page of group chat messages in a community, optionally older than a cursor.community_ chat_ messages list_Read: List the members muted in a community's group chat.community_ chat_ mutes list_Read: List the reports on group chat messages in a community. Resolved reports are left out unless asked for.community_ chat_ reports list_Read: List the discount codes of one of your communities, with their uses and whether each is on.community_ coupons list_Read: List recent events for an owned community with event ids, start times and meeting details.community_ events list_Read: List the people waiting for your host approval to join one of your communities (oldest first, up to 100).community_ join_ requests list_Read: List the Members & requests of an owned or co-admin community, newest first (capped at 100 rows).community_ joins list_Read: List published and draft lesson summaries for an owned community without lesson bodies or private image identifiers.community_ lessons list_Read: List members of an owned community.community_ members list_Read: List reports about messages between members in an owned community.community_ message_ reports list_Read: List member to host message conversations of an owned community, unread first.community_ messages list_Read: Lists this member's pending community approval proposals.community_ pending_ approvals list_Read: List recent lesson questions for an owned community with question ids, lesson ids, reply counts and author names.community_ questions list_Read: Read the average rating and recent reviews of an owned community, with the host's public reply and the member's dates for each review.community_ reviews list_Read: List communities owned by the authenticated user.my_ communities list_Read: The ads the communities you own or joined share in their member kit (label, headline, primary text, image description, settings notes, suggested daily budget).my_ community_ ads member_Read: The communities and courses you have joined as a member, with the same details the app shows.communities member_Read: Upcoming events of a community you joined.community_ events member_Read: The latest posts (pinned first) with replies in a community you joined.community_ feed member_Read: One published lesson with its full text, as you see it in the app.community_ lesson member_Read: The modules and published lessons of a community you joined, showing which are locked and which you completed, plus your progress.community_ lessons member_Read: One community you joined, with its description, categories and your membership.community_ overview member_Read: Your course progress (lessons completed of total) in a community you joined.community_ progress member_Read: Read one member's streak, milestones and kudos in a community.community_ recognition propose_Write: Proposes awarding a community badge to a member.badge_ award propose_Write: Proposes a new community badge.badge_ create propose_Write: Proposes revoking a community badge from a member.badge_ revoke propose_Write: Proposes changing a community badge's name or emoji.badge_ update propose_Write: Proposes a new community post category.category_ create propose_Write: Proposes deleting a community post category.category_ delete propose_Write: Proposes a new order for the community post categories. category_ids must list every existing category exactly once, in the new order.category_ order propose_Write: Proposes renaming a community post category.category_ rename propose_Write: Propose turning the community's group chat on or off for members. The host approves it in the app.community_ chat_ enabled propose_Write: Propose deleting one group chat message for everyone in the room. The host approves it in the app.community_ chat_ message_ delete propose_Write: Propose posting one message in the group chat as the host. The host approves it in the app.community_ chat_ message_ send propose_Write: Propose muting one member in the group chat, optionally for a number of minutes, with a note for hosts. The host approves it in the app.community_ chat_ mute propose_Write: Propose marking a group chat message report as resolved, and optionally deleting the reported message. The host approves it in the app.community_ chat_ report_ resolve propose_Write: Propose lifting the group chat mute on one member. The host approves it in the app.community_ chat_ unmute propose_Write: Proposes turning one of your community discount codes on or off.community_ coupon_ active propose_Write: Proposes a new discount code for one of your communities.community_ coupon_ create propose_Write: Propose community event for approval.community_ event propose_Write: Propose community event update for approval.community_ event_ update propose_Write: Propose community message reply for approval.community_ message_ reply propose_Write: Propose community message settings for approval.community_ message_ settings propose_Write: Proposes changes to a community's page for the host to approve in LeedAgent; nothing changes until the host approves; only name, tagline, description, cover_image_url, icon_url, host_name, host_photo_url, weekly_call_url, weekly_call_schedule, level_names, members_open_on, brand_color and module_thumbnails are accepted, and the server rejects any other key; members_open_on sets the tab members see first (community or classroom); brand_color is the accent colour as #RRGGBB, and an empty value goes back to the default teal; the slug, prices, billing, trial, join and visibility settings cannot be changed here; module_thumbnails is a list of items, each with a module and a url: the url is an https picture link, and module is the lesson section name (an empty module is the Start here module) and an empty url removes that picture; the whole list replaces all module pictures, so send every picture you want to keep; the list can cover up to 100 modules, and a longer list is refused.community_ page_ update propose_Write: Propose community post for approval.community_ post propose_Write: Propose community review reply for approval.community_ review_ reply propose_Write: Propose community welcome message for approval.community_ welcome_ message propose_Write: Propose lesson publish for approval.lesson_ publish propose_Write: Propose lesson update for approval.lesson_ update propose_Write: Propose question reply for approval.question_ reply propose_Write: Propose resolve community message report for approval.resolve_ community_ message_ report remove_Write Needs yes: Remove a kudos. A member can remove their own; a host can remove any. The first call returns a preview.community_ kudos remove_Write: Remove an image from an unpublished lesson draft.lesson_ image set_Write Needs yes: Create or replace the quiz on one lesson of your community.community_ lesson_ quiz set_Write: Change an image caption on an unpublished lesson draft.lesson_ image_ caption update_Write: Update an unpublished lesson draft only.lesson_ draft
Contacts and CRM
add_Write Ask first: Add one tag to a contact. contact_id comes from list_contacts or find results; tag names come from list_contact_tags.contact_ tag assign_Write Needs yes: Assigns a contact to one active team member.contact bulk_Write Ask first: Archive every contact matching a filter.archive_ contacts bulk_Write Ask first: Close every opportunity matching a filter as lost or inactive.close_ opportunities bulk_Write Needs yes: Delete up to 100 contacts by their contact_ids, and they are removed for good.delete_ contacts bulk_Write Ask first: Adds and/or removes existing tags, by name, on every contact that matches a filter, up to 500 contacts per call. Tag names come from list_contact_tags; system tags (ai:, sys:, journey:) are refused. Run preview_bulk_contacts first and pass its filter, preview_token and expected_count back unchanged. Each write needs the customer's yes.tag_ contacts bulk_Write Ask first: Updates the same fields on every contact that matches a filter, using the preview_token and expected_count from a preview; the fields you can change are first_name, last_name, email, phone, custom_fields and lifecycle_status. It changes up to 2000 contacts per call. The AI Desk's bulk status change uses this same tool, and only the account owner or an admin can run it there.update_ contacts complete_Write: Mark a follow-up reminder Done.follow_ up_ reminder contact_Read: Returns how many contacts are on this account.count create_Write: Adds one contact; at least one of first_name, last_name, email or phone is required; if a contact with the same email or phone exists, nothing is created and the matches come back (409); allow_duplicate set to true adds a near-match anyway, but the same exact email or phone is always refused; it counts against the plan's contact limit, and no confirm is needed.contact create_Write: Adds a dependent to an assigned contact; the change can be reversed.contact_ dependent create_Write Ask first: Adds a custom contact field: key is a short unique key, label is the text people see, and field_type, section, options (for choice fields), required and position are optional; ask the user first; no confirm is needed.contact_ field create_Write: Adds a note to a contact.contact_ note create_Write Ask first: Create a contact tag with a name and an optional color.contact_ tag create_Write Ask first: Create a follow-up reminder for a contact at remind_at (ISO 8601 date and time).follow_ up_ reminder create_Write: Adds a note to a lead.lead_ note create_Write Ask first: Creates an opportunity for a contact; value is text such as 1500.00, pipeline_id, stage_id and status (open, won or lost) are optional, and ask the user first; no confirm is needed.opportunity create_Write: Creates a pipeline with a default set of stages.pipeline create_Write: Saves a contact view on this account; the save is reversible.saved_ contact_ view delete_Write Needs yes: Delete one contact from the CRM, and the contact is removed for good.contact delete_Write Needs yes: Delete one dependent from a contact's record.contact_ dependent delete_Write Needs yes: Deletes one document from a contact.contact_ document delete_Write Needs yes: Delete one custom contact field.contact_ field delete_Write Needs yes: Deletes one note from a contact.contact_ note delete_Write Needs yes: Delete a contact tag.contact_ tag delete_Write Needs yes: Delete one follow-up reminder so it never fires.follow_ up_ reminder delete_Write Needs yes: Permanently delete one opportunity (id from list_opportunities or find); this cannot be undone.opportunity delete_Write Needs yes: Delete one sales pipeline and its stages.pipeline delete_Write Needs yes: Delete one saved contact view (a saved filter on the contacts list).saved_ contact_ view edit_Write Ask first: Edit an opportunity's pipeline, stage, value, status, active flag, contact or owner. It also sets the property address, side, expected closing date and commission: commission_type is percent or amount, and commission_value is a percent from 0 to 100 of the deal value, or an amount of 0 or more. An empty commission_value clears it.opportunity export_Read: Exports contacts as CSV rows; optional filters are q, lifecycle_status, ids, archived (true, false or all), created_from and created_to, updated_from and updated_to (ISO dates), has_email, has_phone, assignee, tag_ids, tag_names, opportunity_status (open, won or lost), pipeline_id, stage_id, utm_source and utm_campaign; max_rows (1 to 2000, default 500) sets the row limit, and the reply says when the export was cut short; read-only.contacts find_Read: Lists likely duplicate contacts: pairs that share the same phone number or the same email, not archived, at most 100 pairs. It lists pairs only; it does not merge anything.duplicate_ contacts follow_Write: Hide a contact from the Needs follow-up list for now (it comes back after the snooze window).up_ contact_ not_ now get_Read: Get the CRM account mode and insurance tier of this account.account_ mode get_Read: Returns one activity record.activity get_Read: One contact by id, including lifecycle_status (the Lead/Client badge).contact get_Read: Progress of a contact import: status, processed of total, created, updated, skipped and invalid counts.contact_ import_ progress get_Read: Returns the status of a contact's portal access.contact_ portal_ status get_Read: Get the follow-up notification settings: which channels (sms, telegram, email, browser_push) are on.follow_ up_ notification_ settings get_Read: Returns one opportunity.opportunity get_Read: Get the pipeline notification settings: whether the sound plays and which sound it uses.pipeline_ notification_ settings import_Write Ask first: Step 2: import the spreadsheet that preview_contact_import showed.contacts invite_Write: Sends a contact an invite to the customer portal.contact_ to_ portal list_Read: Lists the activity records on this account.activities list_Read: Lists the dependents on an assigned contact; sensitive fields are returned only when you ask for them by name.contact_ dependents list_Read: Lists the documents on a contact.contact_ documents list_Read: Lists every contact field on the account, built-in and custom. The custom field keys here are the ones you use to filter contacts in list_contact_ fields contacts. list_Read: Lists a contact's notes.contact_ notes list_Read: Lists a contact's tags.contact_ tags list_Read: List contacts (each row has lifecycle_status, the Lead/Client badge). Filter with lifecycle_status, for example lead. Filter with a custom field too: give the field key from list_contacts contact_ fields and the value to match. Matching ignores upper and lower case, and each custom field you add narrows the list further. list_Read: List the Needs follow-up contacts: leads with no activity for the stale-lead window (or ever), minus the ones hidden with follow_up_contact_not_now.contacts_ needing_ follow_ up list_Read: List follow-up reminders (the Today list), soonest first.follow_ up_ reminders list_Read: Lists opportunities.opportunities list_Read: Lists pipelines, each with its stages in order.pipelines list_Read: Lists the saved contact views on this account.saved_ contact_ views list_Read: List the tag folders (id, name, how many tags each holds).tag_ folders merge_Write Needs yes: Merges two duplicate contacts: everything of the other contact (notes, tags, deals, conversations, history) moves to the contact you keep, and the other contact is archived, never deleted. Run preview_contact_merge first.contacts move_Write Ask first: Move an opportunity to another pipeline and stage. opportunity_id, pipeline_id and stage_id come from list_opportunities or find results.opportunity_ pipeline move_Write Ask first: Moves an opportunity to another stage in its pipeline; get the IDs from list_opportunities or find, and each move needs the user's yes.opportunity_ stage preview_Read: Shows how many contacts a filter would touch, and returns a preview_token; run this before a bulk change. Filter keys: ids, exclude_ids (contacts to leave out), tag, stage, pipeline, created_after, created_before, language, language_missing, q, assigned_to, unassigned and lifecycle_status.bulk_ contacts preview_Read: Shows how many opportunities a filter would touch, and returns a preview_token; run this before a bulk change.bulk_ opportunities preview_Read: Step 1 of importing a spreadsheet of contacts.contact_ import preview_Read: Shows what merging two duplicate contacts would do: the contact kept, what moves over, and any clashes. Run it before merge_contacts. Takes keep_contact_id and merge_contact_id.contact_ merge remove_Write: Removes one tag from one contact; the tag itself stays; use the contact_id (a UUID) and the tag name as the contact shows it.contact_ tag revoke_Write: Turns off a contact's portal access.contact_ portal set_Write: Sets whether one document on a contact is shared.contact_ document_ shared set_Write Ask first: Moves a contact tag into a tag folder, or out of its folder when folder_id is null; get folder IDs from list_tag_folders; system tags cannot be moved, nothing is deleted, and no confirm is needed.contact_ tag_ folder set_Write Ask first: Mark one opportunity as won or lost. opportunity_id comes from list_opportunities or find results.opportunity_ status stop_Write: Immediately remove active Conversation AI engage tags for a contact.conversation_ ai_ for_ contact suppress_Write: Stops automation for one contact right away by adding the system tag sys:do-not-automate; the account needs the AI features.contact_ automation suppress_Write: Stops marketing to one contact right away by adding the system tag sys:do-not-market; the account needs the AI features.contact_ marketing update_Write Needs yes: Change the CRM account mode, which changes how the CRM works for the whole account. insurance_tier is sent only when set.account_ mode update_Write Ask first: Updates fields on one contact; get contact_id from list_contacts or find; you can change first_name, last_name, email, phone, custom_fields and lifecycle_status, where lifecycle_status must be one of lead, prospect, applicant, client, policyholder, transaction_party, vendor, buyer, seller, under_contract or past_client; each write needs the user's yes.contact update_Write: Update an assigned contact dependent locally; no published target is involved.contact_ dependent update_Write Ask first: Change a custom contact field's label, field_type, section, options, required flag or position.contact_ field update_Write Ask first: Change the text of one contact note.contact_ note update_Write Ask first: Rename a contact tag or change its color.contact_ tag update_Write Ask first: Turn follow-up notification channels on or off (sms, telegram, email, browser_push).follow_ up_ notification_ settings update_Write Ask first: Move an opportunity to another stage (stage_id or stage_name) or set its status open, won or lost.opportunity update_Write: Renames a pipeline, sets whether it is the default, and changes its stages; stages must be the full ordered list, with each existing stage sent by its id and new stages sent without one, and it adds, renames and reorders stages but never deletes them.pipeline update_Write Ask first: Change the pipeline notification sound. sound_key is chime, bell, ping, pop or soft.pipeline_ notification_ settings upload_Write Ask first: Uploads one file to a contact; send the file as base64 in content_base64, and content_type is PDF, JPEG, PNG, Word (.doc or .docx) or plain text; ask the user first, and no confirm is needed.contact_ document
Conversations and messages
conversation_Read: Returns a summary of one conversation.summary delete_Write Needs yes: Permanently delete one inbox conversation and its messages.conversation disable_Write: Immediately disable Conversation AI for an account conversation.conversation_ ai_ for_ conversation enable_Write Needs yes: Enable Conversation AI for an account conversation - the AI will reply to this customer.conversation_ ai_ for_ conversation get_Read: Returns one conversation.conversation get_Read: The recent messages of one conversation, for drafting a reply. instruction is an optional note about the reply you are drafting.reply_ draft_ context get_Read: WhatsApp and SMS health for the account: sending problems, delivery and analytics over the last days. channel and analytics_channel narrow the result.whatsapp_ diagnostics list_Read: Lists the messages in a conversation.conversation_ messages list_Read: Lists conversations. lost is optional: true keeps only conversations whose contact has a deal marked Lost, false leaves them out, and leaving it out applies no filter.conversations list_Read: The WhatsApp message templates the inbox can use to start a conversation. limit is optional.inbox_ whatsapp_ templates list_Read: The account's WhatsApp message templates with their approval status. status and limit are optional.whatsapp_ templates manage_Write Needs yes: Checks (status), links (creates a pairing code) or unlinks (revokes) the user's Telegram account connection; status needs no confirm, and for link or unlink ask the user to confirm by typing yes before calling, and confirm must be "yes".telegram_ link manage_Write Needs yes: Sets up or changes the WhatsApp numbers on this account (connect, verify, register, set default or delete), with action picking the step and details holding its fields; ask the user first, and steps that go live or remove a number need confirm set to "yes" after they agree; the Meta embedded sign-up completion step is not available here, so finish it in the LeedAgent app.whatsapp_ onboarding mark_Write: Marks a conversation as read.conversation_ read mark_Write: Marks a conversation as unread.conversation_ unread search_Read: Search the account's email, SMS and WhatsApp messages.messages send_Write Needs yes: Send one email, SMS or WhatsApp message to a customer, now.message set_Write Ask first: Mark one inbox conversation done (done=true) or reopen it (done=false).conversation_ done set_Write: Stars or unstars a conversation.conversation_ star sync_Write: Pull new inbound WhatsApp messages into the inbox now. channel is always 'whatsapp'.inbound_ whatsapp
Forms and surveys
create_Write: Creates a saved form; put its settings (description, submit_text and so on) inside form_settings.saved_ form create_Write Ask first: Create a NEW saved survey from fields and slides.saved_ survey delete_Write Needs yes: Delete one of your saved forms.saved_ form delete_Write Needs yes: Delete one of your saved surveys.saved_ survey duplicate_Write: Copies a saved form.saved_ form export_Read: Read the submissions of your forms as a base64 CSV, at most 10,000 rows.form_ submissions export_Read: Read the responses to your surveys as a base64 CSV, at most 10,000 rows.survey_ responses form_Read: Shows totals for a form's submissions.submission_ stats get_Read: Returns one form submission.form_ submission get_Read: Returns one saved form.saved_ form get_Read: Returns one saved survey.saved_ survey get_Read: Read one survey response: its answers, status and survey.survey_ response list_Read: Lists the submissions for a form.form_ submissions list_Read: Lists your saved forms.saved_ forms list_Read: Lists your saved surveys.saved_ surveys list_Read: Lists the submissions for a survey.survey_ submissions preview_Read: Read a preview of one of your saved forms.saved_ form preview_Read: Read a preview of one of your saved surveys.saved_ survey set_Write: Set the status of one form submission (new, contacted, qualified, converted or spam).form_ submission_ status set_Write: Set the status of one survey response (new, contacted, qualified, converted or spam).survey_ response_ status update_Write Needs yes: Edit a saved form's name, submit text or disclaimer. Other settings go in a settings object, for example success_message, button_color, notification_email or form_width. If none of the keys can be changed, the call is refused.form_ settings update_Write Needs yes: Edit a saved form that is on a published page.published_ form update_Write Needs yes: Edit the settings of a saved form that is on a published page (name, submit text, disclaimer, or other settings in a settings object).published_ form_ settings update_Write Needs yes: Edit a saved survey that is on a published page (name, description, fields, slides or submit text).published_ survey update_Write Needs yes: Edit one of your saved surveys (name, description, fields, slides or submit text).saved_ survey update_Write: Changes a form that is not published yet; put its fields (name, fields, submit_text and so on) inside form_fields.unpublished_ form
Google and reviews
create_Write Ask first: Add an external calendar as a conflict calendar on one Google connection, so its busy times block bookings.google_ conflict_ calendar create_Write: Create a review request template (the message sent to customers asking for a Google review) for one channel.google_ review_ request_ template delete_Write Needs yes: Remove a conflict calendar, so its busy times stop blocking bookings.google_ conflict_ calendar delete_Write Needs yes: Delete a review request template you own.google_ review_ request_ template disconnect_Write Needs yes: Disconnect one of your Google connections.google_ connection discover_Read: List the Google Business Profile locations one of your Google connections can see, so you can choose which to review-manage.google_ locations get_Read: Show whether a busy calendar link (a read-only .ics feed, for example a work Outlook calendar) is connected and whether it last loaded fine.google_ busy_ link get_Read: Get your Google Calendar sync settings: the linked calendar, whether appointments are pushed and external events pulled, and the Meet and attendee options.google_ calendar_ settings get_Read: Get the link where the user connects their Google account (Business Profile reviews and/or Calendar).google_ connect_ link get_Read: Read Google connection status for review management without returning OAuth URLs or tokens.google_ connection_ status list_Read: List the Google calendars on one of your Google connections, so you can pick one for Calendar sync (linked_calendar_id) or a conflict calendar (calendar_id).google_ calendars list_Read: List the conflict calendars: the external calendars whose busy times block your bookings.google_ conflict_ calendars list_Read: Lists the Google review locations stored for this account; it does not look for new locations or pick one.google_ locations list_Read: Lists the Google review request templates on this account; it requires the review management feature.google_ review_ request_ templates list_Read: Lists Google review requests with basic details; contact phone numbers, emails and message text are not included.google_ review_ requests prepare_Write Needs yes: SEND one review request (text, email or WhatsApp) to a contact you own, for a location you own. It can also set one reminder withgoogle_ review_ request reminder_enabledandreminder_days(1 to 14, default 3). The reminder is sent only if the contact has not clicked the link.remove_Write Needs yes: Remove the busy calendar link, so its times stop blocking bookings.google_ busy_ link select_Write Ask first: Choose which Business Profile locations to review-manage on one Google connection.google_ locations set_Write Ask first: Connect or replace the busy calendar link, a read-only https .ics feed URL.google_ busy_ link set_Write: Save your own Google review link (the link Google gives a business to ask for reviews) so review requests can go out without connecting Google.google_ review_ link update_Write Ask first: Change your Google Calendar sync settings.google_ calendar_ settings update_Write Ask first: Changes which calendar is checked for conflicts.google_ conflict_ calendar update_Write: Change a review request template you own.google_ review_ request_ template
Media
delete_Write Needs yes: Delete one active image from your media library.media_ asset describe_Write: Looks at one public image URL and describes it, using AI credit; it runs at once with no confirm step.image generate_Write Needs yes: Generates square ad images from a headline, copy, call to action and brand notes, charged to the account's wallet; photo_url puts the member's real photo in a circular frame; ask the user first; the first call returns confirm_required with a preview; show it to the user and, if they agree, call again with confirm set to "yes", and the reply includes the image itself.ad_ image generate_Write Needs yes: Generates images into the media library, charged to the account's wallet; photo_url puts the member's real photo in a circular frame, and include_logo adds the account logo; ask the user first; the first call returns confirm_required with a preview; show it to the user and, if they agree, call again with confirm set to "yes", and the reply includes the image itself.media_ images get_Read: Shows media usage for this account.media_ usage list_Read: Lists the files in the media library.media_ assets move_Write Needs yes: Move one image or video to a media library folder (folder_path like Ads/Spring, up to 5 levels; an empty string is Library home).media_ asset rename_Write Needs yes: Rename one image or video in your media library (original_filename: 1-255 characters, no slashes).media_ asset upload_Write Needs yes: Copy one public remote image URL into your media library.media_ from_ url upload_Write Needs yes: Upload a local image (base64 attachment bytes only, no path or URL) into your media library.media_ image upload_Write Needs yes: Upload a local video (base64 attachment bytes, optional thumbnail) into your media library.media_ video
Phone
add_Write: Adds a phone number to the do-not-call list.do_ not_ call_ entry block_Write: Blocks an incoming caller.inbound_ caller check_Read: Checks whether a number is on the local do-not-call list or the cached national list; it makes no live national lookup.do_ not_ call_ status delete_Write Needs yes: Delete a phone extension by id.phone_ extension delete_Write Needs yes: Delete a phone menu by id.phone_ menu delete_Write Needs yes: Permanently deletes one voicemail; it takes a confirm parameter, so ask the user first.voicemail dismiss_Write: Dismisses missed calls.missed_ calls generate_Write Needs yes: Create an AI-voice voicemail greeting from text and make it the account's voicemail greeting.voicemail_ greeting get_Read: Shows whether the done-for-you SMS registration offer applies to this account; it needs an active LLC and a $30 wallet balance for carrier fees.a2p_ service_ status get_Read: Shows the status of voice calls on this account right now.active_ voice_ status get_Read: The phone system settings: which menu answers during business hours, which answers after hours, and the holiday dates.phone_ system_ settings get_Read: Read the local power-dialer session, current or next attempt, and recent contact call.power_ dialer_ status get_Read: Shows the status and any errors of the SMS brand and campaign registration as last saved in LeedAgent; it does not check again with the carrier.sms_ compliance_ status get_Read: Returns one voice call.voice_ call get_Read: Read local unread voicemail and today's missed-call notification counts.voice_ notification_ counts get_Read: Read the local voice routing profile without creating a missing profile.voice_ routing_ profile get_Read: Read local voice recording, script, quick-reply, and disposition settings without creating a profile.voice_ settings list_Read: List locally blocked inbound spam callers with pagination.blocked_ callers list_Read: List the account's local do-not-call entries with pagination.do_ not_ call_ entries list_Read: List the phone extensions: number, name, who or what it rings (a team member or a cell phone), screening and voicemail settings.phone_ extensions list_Read: List the phone menus with their press-1/2/3 options.phone_ menus list_Read: List due local power-dialer callbacks with pagination, optionally after an ISO datetime.power_ dialer_ callbacks list_Read: List local power-dialer sessions with pagination.power_ dialer_ sessions list_Read: Lists voice calls.voice_ calls list_Read: Lists the voice numbers on this account and whether each is busy on a live call; it makes no provider call.voice_ numbers list_Read: List local voice recording metadata only; audio URLs, transcripts, and content are never returned.voice_ recordings list_Read: List the AI voices for an AI-voice voicemail greeting, with the price per 1,000 characters and the character limit.voicemail_ greeting_ voices list_Read: Lists voicemails.voicemails mark_Write: Marks a voicemail as read.voicemail_ read pause_Write: Pause the local power-dialer session; controls session state only and never places calls.power_ dialer remove_Write Needs yes: Removes a phone number from the do-not-call list.do_ not_ call_ entry resume_Write: Resume the local power-dialer session; controls session state only and never places calls.power_ dialer set_Write: Sets the default SMS number on the local record, with no provider call.default_ sms_ number set_Write: Sets the default voice number on the local record, with no provider call.default_ voice_ number set_Write: Set local voice presence; clearing presence may finalize an active call locally.voice_ presence skip_Write: Skip the current local power-dialer entry; controls session state only and never places calls.power_ dialer_ entry start_Write Needs yes: Calls a phone number from the account's number and connects the call to the signed-in user. from_number and contact_id are optional.outbound_ call start_Write: Start a local power-dialer session and pause any prior session; controls session state only and never places calls.power_ dialer_ session stop_Write: Stop the local power-dialer session; controls session state only and never places calls.power_ dialer submit_Write: Submit a local power-dialer disposition; controls session state only and never places calls.power_ dialer_ disposition transfer_Write Needs yes: Transfer a live call (call_sid) to another phone number now, or to a phone system extension (extension_id from list_phone_extensions).call unblock_Write: Unblocks a caller that was blocked.inbound_ caller update_Write Needs yes: Add a phone extension (leave id out) or change one (give id).phone_ extension update_Write Needs yes: Add a phone menu (leave id out) or change one (give id): the greeting and its digit options.phone_ menu update_Write Needs yes: Choose which phone menu answers calls during business hours and after hours.phone_ system_ settings update_Write Needs yes: Changes voice routing settings; they apply to the next inbound call; set clear_front_desk to true to remove the front desk profile.voice_ routing_ profile update_Write Needs yes: Changes voice recording, script, quick-reply and call-result settings.voice_ settings voice_Read: Shows voice call analytics for this account.analytics
Sites and pages
add_Write Needs yes: Add a goal (what counts as a conversion) to an A/B test.ab_ test_ goal add_Write Needs yes: Add a variant to an A/B test, with its traffic_percentage.ab_ test_ variant archive_Write Needs yes: Archive a completed or stopped A/B test, removing it from the active list.ab_ test build_Write: Builds a page from a brief as a draft, using AI credit; it never publishes the page; to revise it, call again with page_id and expected_artifact_version.page_ draft build_Write: Build up to five ordered website pages as drafts.site_ draft create_Write Needs yes: Create an A/B test on one of your pages (by URL or page name), with an original and a variation split by traffic_split and one primary click-through goal.ab_ test create_Write: Creates a draft page on one of your sites.page_ draft create_Write: Create an account site and keep every created page in draft status.site_ draft declare_Write Needs yes: Declare the winning variant of a running or paused A/B test.ab_ test_ winner delete_Write Needs yes: Delete one goal from an A/B test.ab_ test_ goal delete_Write Needs yes: Delete one variant from an A/B test.ab_ test_ variant duplicate_Write Needs yes: Copy one of your section sites into a new site of drafts: every section page, the theme, the shared header and footer, and the same homepage. Never publishes and uses no AI credit; tracking pixels and domains are not copied. site_id is required. name is optional, and the copy is named after the site with (copy) added.site edit_Read: Deprecated: raw HTML editing was removed; use build_page_draft to build from a brief, or update_page_build_metadata.page_ draft get_Read: Return one page's compact metadata and SEO/QA state, never its content body.page get_Read: Poll a page build until it is Ready or Failed; returns steps, QA, errors, intake questions, and preview URL when ready.page_ build_ status get_Read: Get the ad-based headline report for a page over the last 1-90 days: visits and leads per headline.page_ headline_ report get_Read: Get the ad-based headline settings for a page.page_ headlines get_Read: Read the existing preview URL and staleness indicator; never regenerate a preview.page_ preview get_Read: Shows how many sites and pages the account has used against its plan limits; a degraded state is shown when it applies.page_ usage get_Read: Shows a page's visual check: the Facebook pixel and Google Analytics IDs on it, its status, its public URL, and whether it is live (published with a public URL); a PASS only covers the checks that were actually done.page_ verification get_Read: Return one account site's compact metadata and configuration status, with view_count (total views of its pages that are not archived) and leads_30d (form leads from the last 30 days).site get_Read: Read one of your sites' favicon, default share image and page views (total and per page, as the My Sites screen shows them), plus its form leads from the last 30 days (leads_30d).site_ settings list_Read: List your A/B tests and their status, with optional filters: query (matches name or page), test_id (one test's per-variant results) and status.ab_ tests list_Read: Browse the page template catalog: approved templates for everyone.page_ templates list_Read: Lists a page's saved versions with their details; it does not return the page HTML or a full history.page_ versions list_Read: Lists your pages with their details only; page content and full HTML are not returned.pages list_Read: Lists your sites with their details only; page content and page HTML are not returned. Each site includes view_count (total views of its pages that are not archived) and leads_30d (form leads from the last 30 days).sites pause_Write Needs yes: Pause a running A/B test.ab_ test publish_Write Needs yes: Publishes one of your pages right away after checking it; no AI runs on publish, publishing is safe to repeat, and publish actions are limited to 30 per 24 hours.page restore_Write: Copies an earlier version of a page back into the draft as a new version.page_ version_ to_ draft resume_Write Needs yes: Resume a paused A/B test, so it runs and collects results again.ab_ test section_Read: Lists the section types the page builder offers (hero, services, pricing, faq, blocks and more), or pass type to get one type's variants, field names and default content; read it before adding a section so you only use real types, variants and fields; read-only.catalog_ list section_Write Needs yes: Add a section to one of your section pages.page_ add_ section section_Write Ask first: Copy one of your section pages into a NEW draft on a site you own.page_ clone section_Write Ask first: Create a NEW section page as a draft on a site you own, from a ready layout: 'lander' (lead form landing page) or 'business' (services, testimonials, contact).page_ create section_Write Needs yes: Copy one section with all its fields, placed right after the original.page_ duplicate_ section section_Read: Reads one of your section pages (the beta sectioned editor): its status, public URL, and each section with its ID, type, visibility and current copy; read it before editing so you use the real section IDs; read-only.page_ get section_Read: Get the per-ad headline setup for one section page: whether it is on, the match parameter, the default headline and the current rows.page_ headlines_ get section_Write Needs yes: Change the per-ad headline setup for one section page that has a lander-hero section.page_ headlines_ set section_Write Needs yes: Move a section to just after another section (after_section_id empty = to the top, below the header).page_ move_ section section_Write Needs yes: Publish a section page so it goes live immediately.page_ publish section_Write Needs yes: Remove one section from a section page (not the lead form section).page_ remove_ section section_Write Needs yes: Restore a section page to a saved version from section_page_versions.page_ restore section_Write Needs yes: Edit the copy of one section on a section page.page_ set_ copy section_Write Needs yes: Change fields of a section that is already on the page (text, links, images, options); send only the fields to change.page_ set_ fields section_Write Needs yes: Point the lead form of a section page at a saved form you own, and report its consent and tracking status.page_ set_ form section_Write Needs yes: Hide a section page from search engines (the editor's Hide from search switch) with hide_from_search true, or show it again with false.page_ set_ search_ visibility section_Write Needs yes: Switch a section to another look (variant) of the same type; every field is kept.page_ set_ variant section_Write Needs yes: Take a section page back to draft so it is no longer live.page_ unpublish section_Write Needs yes: Switch one of your section pages to use (or stop using) its site's shared header or footer.page_ use_ site_ section section_Read: List the saved versions of one section page, newest first.page_ versions set_Write: Save the ad-based headline settings for a page.page_ headlines set_Write Needs yes: Set which saved Meta pixel one of your sites uses.site_ pixel site_Read: Reads the site-wide header and footer of one of your sites: the shared sections, the version (send it as base_version when you set them), which pages use each one, and each page's use flags; read-only.shared_ sections_ get site_Write Needs yes: Set or clear the site-wide header or footer of one of your sites.shared_ sections_ set stop_Write Needs yes: Stop a running or paused A/B test.ab_ test unpublish_Write Needs yes: Takes one of your pages offline and cancels any pending publish check; repeating it is safe, and a live page is refused unless override_reason says why, which is logged; publication writes are limited to 30 per 24 hours.page update_Write Needs yes: Change one goal of an A/B test (name, goal type, primary flag or target).ab_ test_ goal update_Write Needs yes: Changes the settings of an A/B test: name, traffic_allocation, confidence_level, minimum_sample_size, minimum_improvement_percentage, maximum_duration_days and primary_metric; ask the user first; the first call returns confirm_required with a preview; show it to the user and, if they agree, call again with confirm set to "yes".ab_ test_ settings update_Write Needs yes: Change one variant of an A/B test (name, control flag, active flag, traffic_percentage or configuration).ab_ test_ variant update_Write Needs yes: Update page metadata only; this never publishes the page.page_ build_ metadata update_Write Needs yes: Set or clear one of your sites' favicon and default share image (https image address; an empty value clears it; a field left out is kept). A page's own share image still wins.site_ settings
Timekeeper
timekeeper_Write: Creates a Timekeeper message template for SMS or email, with merge fields.message_ template_ create timekeeper_Write Needs yes: Permanently deletes one Timekeeper message template.message_ template_ delete timekeeper_Write: Change a Timekeeper message template.message_ template_ update timekeeper_Read: List your Timekeeper message templates, optionally for one channel (sms or email).message_ templates_ list timekeeper_Write: Mark one Timekeeper milestone occurrence as complete.milestone_ complete timekeeper_Write: Reopen a completed or skipped Timekeeper milestone occurrence.milestone_ reopen timekeeper_Write: Skip one Timekeeper milestone occurrence so it no longer needs action.milestone_ skip timekeeper_Write: Snooze one Timekeeper milestone occurrence by a preset (1d or 3d) or until an ISO datetime.milestone_ snooze timekeeper_Write: Apply a Timekeeper plan with an explicit template_key and anchor_dates, to a contact_id or transaction_id (one of them is required).plan_ apply timekeeper_Write Needs yes: Cancels an applied Timekeeper plan and its open milestones.plan_ cancel timekeeper_Read: Shows one Timekeeper plan by its instance_id, with its milestones and their status; read-only.plan_ detail timekeeper_Read: Preview the milestones a Timekeeper template would create from anchor dates, without saving anything. anchor_dates and overrides are objects.plan_ preview timekeeper_Write: Move an applied Timekeeper plan to new anchor_dates and recalculate its milestone dates.plan_ reanchor timekeeper_Read: List your Timekeeper plans (milestone schedules on a contact or transaction), optionally for one contact.plans_ list timekeeper_Read: Read your Timekeeper settings: the daily brief, its hour and timezone, channels, language and contract auto-apply.settings_ get timekeeper_Write: Change your Timekeeper settings (daily brief, hour, timezone, channels, language, contract auto-apply).settings_ update timekeeper_Write: Mark one Timekeeper task as complete.task_ complete timekeeper_Write: Create a Timekeeper task with a title, and optionally a contact, due time and priority.task_ create timekeeper_Write: Create a Timekeeper plan template with a key, a name, anchors and milestones.template_ create timekeeper_Write Needs yes: Permanently deletes one Timekeeper plan template.template_ delete timekeeper_Write: Copy one Timekeeper plan template into a new template.template_ duplicate timekeeper_Write: Change a Timekeeper plan template.template_ update timekeeper_Read: List your Timekeeper plan templates, up to limit.templates_ list timekeeper_Read: Read today's Timekeeper summary: the milestones and tasks that need attention.today timekeeper_Write Needs yes: Complete or snooze all overdue Today items at once, or only the overdue plan steps. The first call only returns the counts and changes nothing. With confirm "yes" the change runs; on the AI Desk that yes first makes one approval card, and the change runs when it is approved.today_ overdue_ bulk
Example: Launch my ads
Launch my ads is the first skill. It builds a Facebook ad from an ad the member's community shares, and it does so in the member's own ad account, with their own Page, pixel, pages and logo. It runs these steps in order.
Check the account in order: Facebook connected, the ad account active, a Facebook Page, a pixel saved and on the pages, pages published, licensed states, a headshot, and a logo. Stop at the first one that is not met and fix it before going on.
Read the ad the community shares: its copy, settings and image description. The skill rebuilds it in the member's own account. It does not copy another account's campaign, image or results.
Generate the ad image from the shared image description. It costs money, so the member says yes first. The image shows the member's logo.
Run the compliance review on the exact headline, text and link. A blocked review stops the launch. A review that needs a look goes in as one short warning in the preview.
Show the exact preview with the names, budget, audience and copy. On the member's yes, build the campaign with every part paused.
Ask "Turn it on now?" as a separate question. The campaign runs only after that second yes.
Creating the campaign and turning it on are two separate yeses. A failed step stops the skill and tells the customer plainly what went wrong. Nothing is turned on by a failed step.
Later
Members and developers will be able to build skills later.