Let your AI run your Instagram.

Returns the connected Instagram account, plan and this month’s usage against the plan limits (active contacts, AI replies, automations, campaigns, seats). Call this first to orient yourself.

Aggregated performance for the last N days: inbound/outbound messages, activated contacts, link clicks (conversions), and the top automations by conversions.

Attribute a sale to the DM that caused it. DMowl links forward with a `dmo` URL parameter (Stripe Payment Links: client_reference_id "dmo_<id>") — pass that value as `ref`. Idempotent per order_id. Sales without a DMowl ref are ignored.

Search the CRM. Filter by text (name, @handle, email), folder, follower status or having an email. Returns at most `limit` contacts, newest activity first.

One contact with folders, custom properties and their latest 20 messages.

Set email/phone, merge custom properties, and add or remove folders. Properties are merged, not replaced; set a property to null to delete it.

Folders (segments/tags) with contact counts. Use folder ids for filtering, campaign audiences and automation steps.

Create a folder to segment contacts.

Send a direct message to a contact as the account owner. Instagram only delivers business messages within 24 hours of the contact’s last message. Sending pauses automations and AI for that contact (a human took over) unless keep_automation is true.

Decide who handles a conversation: "human" (you; automations pause), "agent" (AI agent replies) or "none" (automations decide).

All automations (scenarios) with trigger, steps, status and performance.

One automation with its full trigger and steps.

Create an automation as a draft. trigger.type: comment | dm | story_reply | mention | live_comment. trigger.match: "keywords" (with trigger.keywords) or "any". For comment triggers set commentReplies (public reply variants) and optionally posts="selected" + postIds. Activate it afterwards with set_automation_status. Prefer create_automation_from_prompt or create_automation_from_template when you don’t need full control.

Describe a comment-to-DM automation in plain language (e.g. "send my PDF to everyone who comments GUIDE"). DMowl drafts keywords, replies, DM and link. Returns the draft — review, then activate.

Proven automation and campaign templates. Use a slug with create_automation_from_template.

Copy a template into a new draft automation, optionally overriding the trigger keywords.

Replace name, trigger and/or steps of an automation. Omitted fields stay unchanged. Trigger fields are merged.

Set status to "active" (starts reacting to real comments/DMs) or "paused". Activation validates keywords and steps and respects plan limits.

Manually start an automation’s steps for one contact (skips the trigger).

Permanently delete an automation. Its past messages stay in the inbox.

DM campaigns with status and results (sent, replied, conversions).

Create a draft campaign. audience.type: "active" (wrote in last 24h — safest under Instagram rules), "all", "followers" or "folder" (+ folder_id). Send it with send_campaign.

Send a draft campaign now, or schedule it with an ISO timestamp in `at`. This messages real people — confirm with the user before calling.

Giveaways with entry counts, status and winners (if drawn).

Create a giveaway. Then create an entry automation with a "giveaway" step (or ask the user to click “Create entry automation” in the app).

Draw winners at random (follow re-verified), optionally DM them, and return the auditable draw record. Irreversible — confirm with the user first.

The AI agent’s activation mode and full configuration (voice, goals, knowledge base, links, handoff rules).

Change mode ("all" | "intents" | "automation" | "off") and/or merge config fields: role, length, styleRules, examples, description, goals, audience, instructions, knowledge, collect[], handoffKeywords, links[{label,url}], excludedFolders[], intents. Tip: append to `knowledge` rather than replacing it.