@moltflow/skills 2.0.0 → 2.1.0

package/CHANGELOG.md

@@ -4,6 +4,26 @@ All notable changes to the **MoltFlow Skills** package are documented here.
 
 ---
 
+## [2.1.0] - 2026-02-12 — "Import & Delete"
+
+> Import contacts from WhatsApp groups, delete your account with full cascade, and GDPR scripts for everything.
+
+### Added
+
+- **WhatsApp Group Import** — `GET /custom-groups/wa-groups` lists all WA groups across sessions; `POST /custom-groups/from-wa-groups` creates a custom group by resolving and deduplicating participants from selected WA groups
+- **Account Deletion** — `DELETE /users/me` with password confirmation cascades through 32+ tables (GDPR Article 17)
+- `outreach.py` — added `list_wa_groups()` and `create_group_from_wa_groups()` functions
+- `gdpr.py` — added `delete_account(password)` function
+- Scripts table — added `gdpr.py` and `group_monitor.py` to main SKILL.md documentation
+- moltflow-outreach sub-skill — documented WA group import endpoints and examples
+
+### Changed
+
+- Custom Groups endpoint table expanded from 10 to 12 endpoints (both main SKILL.md and moltflow-outreach)
+- Version bumped to 2.1.0 across package.json, main SKILL.md, and moltflow-outreach
+
+---
+
 ## [2.0.0] - 2026-02-12 — "The Full Platform"
 
 > Every feature, every endpoint, every workflow — v2 is the complete MoltFlow experience.

package/SKILL.md

@@ -1,14 +1,15 @@
 ---
-name: "WhatsApp Automation & A2A"
-version: "2.0.0"
-description: "MoltFlow — complete WhatsApp automation platform: bulk messaging, scheduled messages, custom groups, lead detection & CRM, AI replies with style cloning, knowledge base (RAG), voice transcription, group monitoring, labels, anti-spam, content safeguards, review collection, webhooks, GDPR compliance, and agent-to-agent protocol (JSON-RPC, encryption). 90+ API endpoints."
+name: "MoltFlow — WhatsApp AI Automation Platform and More"
+version: "2.1.0"
+description: "MoltFlow — complete WhatsApp automation platform: bulk messaging, scheduled messages, custom groups, lead detection & CRM, AI replies with style cloning, knowledge base (RAG), voice transcription, group monitoring, labels, anti-spam, content safeguards, review collection, webhooks, GDPR compliance (data export, contact erasure, account deletion), and agent-to-agent protocol (JSON-RPC, encryption). 90+ API endpoints."
 source: "MoltFlow Team"
 risk: safe
+homepage: "https://molt.waiflow.app"
 requiredEnv:
   - MOLTFLOW_API_KEY
 primaryEnv: MOLTFLOW_API_KEY
-disableModelInvocation: true
-metadata: {"openclaw":{"emoji":"📱","homepage":"https://waiflow.app","requires":{"env":["MOLTFLOW_API_KEY"]},"primaryEnv":"MOLTFLOW_API_KEY"}}
+disable-model-invocation: true
+metadata: {"openclaw":{"emoji":"📱","homepage":"https://molt.waiflow.app","requires":{"env":["MOLTFLOW_API_KEY"]},"primaryEnv":"MOLTFLOW_API_KEY"}}
 ---
 
 # WhatsApp Automation & A2A
@@ -24,7 +25,7 @@ MoltFlow is a complete WhatsApp automation platform with 90+ API endpoints cover
 | **Messaging** | Send text, media, polls, stickers, GIFs, voice notes, locations, vCards. Reply, react, edit, unsend. Read receipts & typing simulation. |
 | **Bulk Messaging** | Broadcast to custom groups with ban-safe throttling (random 30s–2min delays). Real-time progress via SSE. Pause/resume/cancel. |
 | **Scheduled Messages** | One-time, daily, weekly, monthly, or custom cron. Timezone-aware. Pause, resume, edit. Execution history tracking. |
-| **Custom Groups** | Build targeted contact lists. Import from WhatsApp groups or add manually. Feed into Bulk Send or Scheduled Messages. CSV/JSON export. |
+| **Custom Groups** | Build targeted contact lists. Import members from WhatsApp groups or add manually. Feed into Bulk Send or Scheduled Messages. CSV/JSON export. |
 | **Lead Detection & CRM** | Auto-detect purchase intent in monitored groups. Lead pipeline with status tracking (new → contacted → qualified → converted). Bulk status update, bulk add-to-group, CSV/JSON export. Reciprocity check (anti-spam). |
 | **Group Monitoring** | Monitor 50+ groups simultaneously. Keyword/mention detection. Auto-respond with AI. Per-group prompts. Skip admins & existing contacts. |
 | **Labels** | Create, sync to WhatsApp Business, import from WhatsApp. Color-coded contact organization. |
@@ -37,7 +38,7 @@ MoltFlow is a complete WhatsApp automation platform with 90+ API endpoints cover
 | **Content Safeguards** | Block API keys, credit cards, SSNs, PII, prompt injection. Custom regex rules. Test content against full policy stack. |
 | **Webhooks** | 10+ event types (message.received, lead.detected, session.connected, etc.). HMAC-SHA256 signed. Delivery history. Test payloads. |
 | **A2A Protocol** | JSON-RPC 2.0 agent-to-agent communication. X25519-AES256GCM encryption. Agent discovery, trust levels, encrypted messaging. |
-| **GDPR Compliance** | Auto-expiring messages (90-day). Data minimization (500-char preview). Contact erasure. Data export. AI consent enforcement. DPA available. Named sub-processors (Art. 28). |
+| **GDPR Compliance** | Auto-expiring messages (90-day). Data minimization (500-char preview). Contact erasure. Data export. Account deletion (32+ table cascade). AI consent enforcement. DPA available. Named sub-processors (Art. 28). |
 | **Billing & Usage** | Stripe-powered. Free/Starter/Pro/Business plans. Usage tracking, daily breakdown. Billing portal. **Yearly plans save up to 17%.** |
 
 ## When to use
@@ -121,6 +122,8 @@ Env vars:
 - `MOLTFLOW_API_KEY` (required) — API key from waiflow.app dashboard
 - `MOLTFLOW_API_URL` (optional) — defaults to `https://apiv2.waiflow.app`
 
+**Security note:** Use the principle of least privilege. If you only need messaging and monitoring features, create a non-admin API key. Admin-level keys grant access to tenant management, user operations, and GDPR erasure endpoints. Only supply an admin key if you explicitly need those capabilities.
+
 Authentication: `X-API-Key: $MOLTFLOW_API_KEY` header or `Authorization: Bearer $TOKEN` (JWT from login).
 
 Base URL: `https://apiv2.waiflow.app/api/v2`
@@ -780,6 +783,16 @@ curl -X POST -H "X-API-Key: $MOLTFLOW_API_KEY" \
 # Export as CSV
 curl -H "X-API-Key: $MOLTFLOW_API_KEY" \
   https://apiv2.waiflow.app/api/v2/custom-groups/{group_id}/export/csv
+
+# List WhatsApp groups available for import
+curl -H "X-API-Key: $MOLTFLOW_API_KEY" \
+  https://apiv2.waiflow.app/api/v2/custom-groups/wa-groups
+
+# Create group by importing members from WhatsApp groups
+curl -X POST -H "X-API-Key: $MOLTFLOW_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"name": "Imported Leads", "wa_groups": [{"wa_group_id": "123@g.us", "session_id": "session-uuid"}]}' \
+  https://apiv2.waiflow.app/api/v2/custom-groups/from-wa-groups
 ```
 
 | Endpoint | Method | Description |
@@ -787,6 +800,8 @@ curl -H "X-API-Key: $MOLTFLOW_API_KEY" \
 | `/custom-groups` | GET | List all custom groups |
 | `/custom-groups` | POST | Create group (with optional initial members) |
 | `/custom-groups/contacts` | GET | List all unique contacts across sessions |
+| `/custom-groups/wa-groups` | GET | List WhatsApp groups for import |
+| `/custom-groups/from-wa-groups` | POST | Create group by importing WA group members |
 | `/custom-groups/{id}` | GET | Group details with members |
 | `/custom-groups/{id}` | PATCH | Update group name |
 | `/custom-groups/{id}` | DELETE | Delete group and members |
@@ -1067,6 +1082,8 @@ The `scripts/` directory contains standalone Python examples (requires `requests
 | `reviews.py` | Create collectors, export testimonials |
 | `outreach.py` | Bulk send, scheduled messages, custom groups |
 | `leads.py` | Lead pipeline, bulk ops, CSV/JSON export |
+| `gdpr.py` | Contact erasure, data export, account deletion |
+| `group_monitor.py` | WhatsApp group monitoring & lead detection |
 
 Run any script: `MOLTFLOW_API_KEY=your-key python scripts/quickstart.py`
 

package/moltflow/SKILL.md

@@ -7,7 +7,7 @@ risk: safe
 requiredEnv:
   - MOLTFLOW_API_KEY
 primaryEnv: MOLTFLOW_API_KEY
-disableModelInvocation: true
+disable-model-invocation: true
 ---
 
 > **MoltFlow** -- WhatsApp Business automation for teams. Connect, monitor, and automate WhatsApp at scale.

package/moltflow-a2a/SKILL.md

@@ -7,7 +7,7 @@ risk: safe
 requiredEnv:
   - MOLTFLOW_API_KEY
 primaryEnv: MOLTFLOW_API_KEY
-disableModelInvocation: true
+disable-model-invocation: true
 ---
 
 > **MoltFlow** -- WhatsApp Business automation for teams. Connect, monitor, and automate WhatsApp at scale.

package/moltflow-admin/SKILL.md

@@ -7,7 +7,7 @@ risk: safe
 requiredEnv:
   - MOLTFLOW_API_KEY
 primaryEnv: MOLTFLOW_API_KEY
-disableModelInvocation: true
+disable-model-invocation: true
 ---
 
 > **MoltFlow** — WhatsApp Business automation for teams. Connect, monitor, and automate WhatsApp at scale.

package/moltflow-ai/SKILL.md

@@ -7,7 +7,7 @@ risk: safe
 requiredEnv:
   - MOLTFLOW_API_KEY
 primaryEnv: MOLTFLOW_API_KEY
-disableModelInvocation: true
+disable-model-invocation: true
 ---
 
 > **MoltFlow** -- WhatsApp Business automation for teams. Connect, monitor, and automate WhatsApp at scale.

package/moltflow-leads/SKILL.md

@@ -7,7 +7,7 @@ risk: safe
 requiredEnv:
   - MOLTFLOW_API_KEY
 primaryEnv: MOLTFLOW_API_KEY
-disableModelInvocation: true
+disable-model-invocation: true
 ---
 
 > **MoltFlow** -- WhatsApp Business automation for teams. Connect, monitor, and automate WhatsApp at scale.

package/moltflow-outreach/SKILL.md

@@ -2,12 +2,12 @@
 name: moltflow-outreach
 description: "Bulk messaging, scheduled messages, and custom groups for WhatsApp outreach. Use when: bulk send, broadcast, schedule message, cron, custom group, contact list, ban-safe messaging."
 source: "MoltFlow Team"
-version: "2.0.0"
+version: "2.1.0"
 risk: safe
 requiredEnv:
   - MOLTFLOW_API_KEY
 primaryEnv: MOLTFLOW_API_KEY
-disableModelInvocation: true
+disable-model-invocation: true
 ---
 
 > **MoltFlow** -- WhatsApp Business automation for teams. Connect, monitor, and automate WhatsApp at scale.
@@ -57,6 +57,8 @@ Build targeted contact lists for Bulk Send and Scheduled Messages. Custom Groups
 | GET | `/custom-groups` | List all custom groups |
 | POST | `/custom-groups` | Create group (with optional initial members) |
 | GET | `/custom-groups/contacts` | List all unique contacts across sessions |
+| GET | `/custom-groups/wa-groups` | List WhatsApp groups for import |
+| POST | `/custom-groups/from-wa-groups` | Create group by importing WA group members |
 | GET | `/custom-groups/{id}` | Group details with members |
 | PATCH | `/custom-groups/{id}` | Update group name |
 | DELETE | `/custom-groups/{id}` | Delete group and members |
@@ -81,6 +83,28 @@ Build targeted contact lists for Bulk Send and Scheduled Messages. Custom Groups
 
 Members is an array of objects with `phone` (required) and `name` (optional). Omit `members` to create an empty group.
 
+### Create Group from WhatsApp Groups
+
+**POST** `/custom-groups/from-wa-groups`
+
+```json
+{
+  "name": "Imported Leads",
+  "wa_groups": [
+    {"wa_group_id": "120363012345@g.us", "session_id": "session-uuid-..."},
+    {"wa_group_id": "120363067890@g.us", "session_id": "session-uuid-..."}
+  ]
+}
+```
+
+Resolves participants from each WhatsApp group, deduplicates by phone number, and creates the custom group with all unique members.
+
+### List WhatsApp Groups
+
+**GET** `/custom-groups/wa-groups`
+
+Returns all WhatsApp groups across your connected sessions with participant counts. Use this to discover groups available for import.
+
 **Response** `201 Created`:
 
 ```json

package/moltflow-reviews/SKILL.md

@@ -7,7 +7,7 @@ risk: safe
 requiredEnv:
   - MOLTFLOW_API_KEY
 primaryEnv: MOLTFLOW_API_KEY
-disableModelInvocation: true
+disable-model-invocation: true
 ---
 
 > **MoltFlow** — WhatsApp Business automation for teams. Connect, monitor, and automate WhatsApp at scale.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moltflow/skills",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "MoltFlow — complete WhatsApp automation platform: bulk messaging, scheduled messages, custom groups, lead detection & CRM, AI replies with style cloning, knowledge base (RAG), voice transcription, group monitoring, labels, anti-spam, content safeguards, review collection, webhooks, GDPR compliance, and agent-to-agent protocol. 90+ API endpoints.",
   "license": "MIT",
   "private": false,

package/scripts/gdpr.py

@@ -0,0 +1,81 @@
+#!/usr/bin/env python3
+"""
+MoltFlow GDPR - Contact Erasure & Data Export
+"""
+import os
+import json
+import requests
+
+API_KEY = os.environ.get("MOLTFLOW_API_KEY")
+BASE_URL = os.environ.get("MOLTFLOW_API_URL", "https://apiv2.waiflow.app")
+
+if not API_KEY:
+    print("Error: MOLTFLOW_API_KEY environment variable not set")
+    exit(1)
+
+headers = {"X-API-Key": API_KEY, "Content-Type": "application/json"}
+
+
+def erase_contact(phone: str, reason: str = "gdpr_request"):
+    """Erase all data for a contact phone number (GDPR Article 17).
+
+    Deletes messages, reviews, anonymizes chats and group memberships.
+    phone: e.g. "972501234567" or "972501234567@c.us"
+    """
+    r = requests.post(
+        f"{BASE_URL}/api/v2/gdpr/contact-erasure",
+        headers=headers,
+        json={"phone": phone, "reason": reason},
+    )
+    r.raise_for_status()
+    return r.json()
+
+
+def export_my_data():
+    """Export all account data as JSON (GDPR Article 20 - Data Portability).
+
+    Returns profile, sessions, chats, messages, groups, labels, webhooks, etc.
+    """
+    r = requests.get(f"{BASE_URL}/api/v2/users/me/export", headers=headers)
+    r.raise_for_status()
+    return r.json()
+
+
+def save_export(filepath: str = None):
+    """Export account data and save to a JSON file."""
+    data = export_my_data()
+    if not filepath:
+        from datetime import datetime
+        filepath = f"moltflow-data-export-{datetime.utcnow().strftime('%Y%m%d')}.json"
+    with open(filepath, "w", encoding="utf-8") as f:
+        json.dump(data, f, indent=2, ensure_ascii=False)
+    return filepath
+
+
+def delete_account(password: str):
+    """Delete your account and all associated data (GDPR Article 17).
+
+    Requires password confirmation. Permanently removes all tenant-scoped
+    data (32+ tables) including sessions, messages, groups, labels, etc.
+    """
+    r = requests.delete(
+        f"{BASE_URL}/api/v2/users/me",
+        headers=headers,
+        json={"current_password": password},
+    )
+    r.raise_for_status()
+    return {"status": "deleted"}
+
+
+if __name__ == "__main__":
+    print("MoltFlow GDPR Tools")
+    print("=" * 40)
+    print("\nAvailable operations:")
+    print("  erase_contact(phone, reason)  - Erase all data for a contact")
+    print("  export_my_data()              - Export all account data as JSON")
+    print("  save_export(filepath)         - Export and save to file")
+    print("  delete_account(password)      - Delete account and all data")
+    print("\nExample:")
+    print('  from gdpr import erase_contact')
+    print('  result = erase_contact("972501234567")')
+    print(f"  print(result)")

package/scripts/group_monitor.py

@@ -0,0 +1,123 @@
+#!/usr/bin/env python3
+"""
+MoltFlow Group Monitor - WhatsApp Group Monitoring & Lead Detection
+"""
+import os
+import requests
+
+API_KEY = os.environ.get("MOLTFLOW_API_KEY")
+BASE_URL = os.environ.get("MOLTFLOW_API_URL", "https://apiv2.waiflow.app")
+
+if not API_KEY:
+    print("Error: MOLTFLOW_API_KEY environment variable not set")
+    exit(1)
+
+headers = {"X-API-Key": API_KEY, "Content-Type": "application/json"}
+
+
+def list_monitored_groups():
+    """List all monitored WhatsApp groups."""
+    r = requests.get(f"{BASE_URL}/api/v2/groups", headers=headers)
+    r.raise_for_status()
+    return r.json()
+
+
+def list_available_groups(session_id: str):
+    """List available WhatsApp groups for a session (not yet monitored)."""
+    r = requests.get(
+        f"{BASE_URL}/api/v2/groups/available/{session_id}",
+        headers=headers,
+    )
+    r.raise_for_status()
+    return r.json()
+
+
+def add_monitored_group(
+    session_id: str,
+    wa_group_id: str,
+    name: str = None,
+    monitor_mode: str = "first_message",
+    monitor_keywords: list = None,
+    monitor_prompt: str = None,
+    auto_respond: bool = False,
+    response_template: str = None,
+    auto_label_leads: bool = False,
+    lead_label_id: str = None,
+    webhook_url: str = None,
+):
+    """Add a WhatsApp group to monitoring.
+
+    monitor_mode: first_message, keyword, ai_prompt
+    monitor_keywords: list of keyword strings (for keyword mode)
+    monitor_prompt: AI prompt (for ai_prompt mode)
+    auto_respond: send automatic response to detected leads
+    auto_label_leads: auto-apply a label to detected leads
+    """
+    data = {
+        "session_id": session_id,
+        "wa_group_id": wa_group_id,
+        "monitor_mode": monitor_mode,
+        "auto_respond": auto_respond,
+        "auto_label_leads": auto_label_leads,
+    }
+    if name:
+        data["name"] = name
+    if monitor_keywords:
+        data["monitor_keywords"] = monitor_keywords
+    if monitor_prompt:
+        data["monitor_prompt"] = monitor_prompt
+    if response_template:
+        data["response_template"] = response_template
+    if lead_label_id:
+        data["lead_label_id"] = lead_label_id
+    if webhook_url:
+        data["webhook_url"] = webhook_url
+    r = requests.post(f"{BASE_URL}/api/v2/groups", headers=headers, json=data)
+    r.raise_for_status()
+    return r.json()
+
+
+def get_monitored_group(group_id: str):
+    """Get monitored group details."""
+    r = requests.get(f"{BASE_URL}/api/v2/groups/{group_id}", headers=headers)
+    r.raise_for_status()
+    return r.json()
+
+
+def update_monitored_group(group_id: str, **kwargs):
+    """Update monitoring settings.
+
+    Accepts: name, monitor_mode, monitor_keywords, monitor_prompt,
+             auto_respond, response_template, auto_label_leads,
+             lead_label_id, webhook_url, is_active
+    """
+    r = requests.patch(
+        f"{BASE_URL}/api/v2/groups/{group_id}",
+        headers=headers,
+        json={k: v for k, v in kwargs.items() if v is not None},
+    )
+    r.raise_for_status()
+    return r.json()
+
+
+def delete_monitored_group(group_id: str):
+    """Stop monitoring a group and remove it."""
+    r = requests.delete(f"{BASE_URL}/api/v2/groups/{group_id}", headers=headers)
+    r.raise_for_status()
+    return r.json()
+
+
+if __name__ == "__main__":
+    print("MoltFlow Group Monitor")
+    print("=" * 40)
+
+    data = list_monitored_groups()
+    groups = data.get("items", [])
+    print(f"\nMonitored Groups: {data.get('total', len(groups))}")
+
+    for g in groups:
+        status = "active" if g.get("is_active") else "paused"
+        mode = g.get("monitor_mode", "unknown")
+        leads = g.get("leads_detected", 0)
+        msgs = g.get("messages_processed", 0)
+        print(f"  - {g['name']} [{status}] mode={mode} leads={leads} msgs={msgs}")

package/scripts/outreach.py

@@ -62,6 +62,71 @@ def export_group_csv(group_id: str):
     return r.text
 
 
+def get_custom_group(group_id: str):
+    """Get custom group details."""
+    r = requests.get(f"{BASE_URL}/api/v2/custom-groups/{group_id}", headers=headers)
+    r.raise_for_status()
+    return r.json()
+
+
+def update_custom_group(group_id: str, name: str):
+    """Update custom group name."""
+    r = requests.patch(
+        f"{BASE_URL}/api/v2/custom-groups/{group_id}",
+        headers=headers,
+        json={"name": name},
+    )
+    r.raise_for_status()
+    return r.json()
+
+
+def delete_custom_group(group_id: str):
+    """Delete a custom group."""
+    r = requests.delete(f"{BASE_URL}/api/v2/custom-groups/{group_id}", headers=headers)
+    r.raise_for_status()
+    return r.json()
+
+
+def remove_members(group_id: str, member_ids: list):
+    """Remove members from a custom group. member_ids = list of member UUID strings."""
+    r = requests.post(
+        f"{BASE_URL}/api/v2/custom-groups/{group_id}/members/remove",
+        headers=headers,
+        json={"member_ids": member_ids},
+    )
+    r.raise_for_status()
+    return r.json()
+
+
+def list_contacts():
+    """List all available contacts for group building."""
+    r = requests.get(f"{BASE_URL}/api/v2/custom-groups/contacts", headers=headers)
+    r.raise_for_status()
+    return r.json()
+
+
+def list_wa_groups():
+    """List WhatsApp groups across all working sessions (for import into custom groups)."""
+    r = requests.get(f"{BASE_URL}/api/v2/custom-groups/wa-groups", headers=headers)
+    r.raise_for_status()
+    return r.json()
+
+
+def create_group_from_wa_groups(name: str, wa_groups: list):
+    """Create a custom group by importing members from WhatsApp groups.
+
+    wa_groups: list of {"wa_group_id": str, "session_id": str} dicts.
+    Members are resolved from each WA group's participant list and deduplicated.
+    """
+    r = requests.post(
+        f"{BASE_URL}/api/v2/custom-groups/from-wa-groups",
+        headers=headers,
+        json={"name": name, "wa_groups": wa_groups},
+    )
+    r.raise_for_status()
+    return r.json()
+
+
 def export_group_json(group_id: str):
     """Export group members as JSON."""
     r = requests.get(
@@ -130,6 +195,13 @@ def cancel_bulk_job(job_id: str):
     return r.json()
 
 
+def get_bulk_progress(job_id: str):
+    """Get real-time progress of a bulk send job."""
+    r = requests.get(f"{BASE_URL}/api/v2/bulk-send/{job_id}/progress", headers=headers)
+    r.raise_for_status()
+    return r.json()
+
+
 # ============================================================================
 # Scheduled Messages
 # ============================================================================
@@ -208,6 +280,38 @@ def cancel_scheduled(message_id: str):
     return r.json()
 
 
+def get_scheduled_message(message_id: str):
+    """Get scheduled message details."""
+    r = requests.get(f"{BASE_URL}/api/v2/scheduled-messages/{message_id}", headers=headers)
+    r.raise_for_status()
+    return r.json()
+
+
+def update_scheduled_message(message_id: str, **kwargs):
+    """Update a scheduled message. Accepts: name, message_content, scheduled_time, cron_expression, timezone."""
+    r = requests.patch(
+        f"{BASE_URL}/api/v2/scheduled-messages/{message_id}",
+        headers=headers,
+        json={k: v for k, v in kwargs.items() if v is not None},
+    )
+    r.raise_for_status()
+    return r.json()
+
+
+def delete_scheduled(message_id: str):
+    """Delete a scheduled message."""
+    r = requests.delete(f"{BASE_URL}/api/v2/scheduled-messages/{message_id}", headers=headers)
+    r.raise_for_status()
+    return r.json()
+
+
+def get_scheduled_history(message_id: str):
+    """Get execution history for a scheduled message."""
+    r = requests.get(f"{BASE_URL}/api/v2/scheduled-messages/{message_id}/history", headers=headers)
+    r.raise_for_status()
+    return r.json()
+
+
 if __name__ == "__main__":
     print("MoltFlow Outreach")
     print("=" * 40)