API Reference

curl "https://motherbot.io/api/v1/analytics/summary?days=7" \
  -H "Authorization: Bearer motherbot_xxx"

{
  "success": true,
  "data": {
    "period": {
      "days": 7,
      "from": "2026-06-17T00:00:00.000Z",
      "to":   "2026-06-24T00:00:00.000Z"
    },
    "messages": {
      "total": 4821,
      "sent": 3200,
      "received": 1621,
      "delivered": 3050,
      "read": 2400,
      "failed": 150,
      "deliveryRate": 95,
      "readRate": 78
    },
    "contacts": { "total": 12400 },
    "campaigns": {
      "total": 5,
      "draft": 1,
      "scheduled": 1,
      "running": 1,
      "paused": 0,
      "completed": 2,
      "failed": 0
    }
  }
}

curl "https://motherbot.io/api/v1/channels" \
  -H "Authorization: Bearer motherbot_xxx"

# Just the WhatsApp numbers
curl "https://motherbot.io/api/v1/channels?channel=whatsapp" \
  -H "Authorization: Bearer motherbot_xxx"

{
  "success": true,
  "data": [
    {
      "id": "66f1c2a0d3b4e5f6a7b8c9d0",
      "channel": "whatsapp",
      "provider": "meta",
      "label": "Acme Retail",
      "identifier": "919876543210",
      "isDefault": true,
      "status": "connected",
      "capabilities": {
        "template": true,
        "text": true,
        "media": ["image", "video", "document", "audio"],
        "interactive": ["button", "list", "cta_url", "flow", "location_request"]
      }
    },
    {
      "id": "66f1c2a0d3b4e5f6a7b8c9d1",
      "channel": "sms",
      "provider": "msg91",
      "label": "MSG91 — ACMERT",
      "identifier": "ACMERT",
      "isDefault": false,
      "status": "connected",
      "capabilities": { "template": false, "text": true, "media": [], "interactive": [] }
    }
  ]
}

curl "https://motherbot.io/api/v1/contacts?tag=vip&limit=50" \
  -H "Authorization: Bearer motherbot_xxx"

{
  "success": true,
  "data": [
    {
      "_id": "664a1f...",
      "channel": "whatsapp",
      "channelId": "919876543210",
      "phoneNumber": "919876543210",
      "waId": "919876543210",
      "name": "John Doe",
      "email": "john@example.com",
      "tags": ["vip", "mumbai"],
      "optedIn": true,
      "blocked": false,
      "customFields": { "cf1": "Acme Ltd", "cf2": "gold" },
      "source": "api",
      "createdAt": "2026-05-01T10:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1, "limit": 50, "total": 284, "pages": 6
  }
}

curl -X POST "https://motherbot.io/api/v1/contacts" \
  -H "Authorization: Bearer motherbot_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneNumber": "919876543210",
    "name": "Priya Sharma",
    "email": "priya@example.com",
    "tags": ["new-user", "delhi"],
    "customFields": { "cf1": "Acme Ltd", "cf2": "gold" }
  }'

# A Telegram contact — the chat id is the identity, and there is no phone number
curl -X POST "https://motherbot.io/api/v1/contacts" \
  -H "Authorization: Bearer motherbot_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "telegram",
    "channelId": "5551234567",
    "name": "Priya Sharma",
    "tags": ["telegram"]
  }'

{
  "success": true,
  "data": {
    "_id": "664a1f...",
    "channel": "whatsapp",
    "channelId": "919876543210",
    "phoneNumber": "919876543210",
    "waId": "919876543210",
    "name": "Priya Sharma",
    "email": "priya@example.com",
    "tags": ["new-user", "delhi"],
    "customFields": { "cf1": "Acme Ltd", "cf2": "gold" },
    "optedIn": true,
    "blocked": false,
    "source": "api",
    "createdAt": "2026-06-24T09:00:00.000Z"
  }
}

curl "https://motherbot.io/api/v1/contacts/664a1f..." \
  -H "Authorization: Bearer motherbot_xxx"

{
  "success": true,
  "data": {
    "_id": "664a1f...",
    "phoneNumber": "919876543210",
    "name": "Priya Sharma",
    "tags": ["vip", "delhi"],
    "optedIn": true,
    "blocked": false,
    "customFields": { "cf1": "Acme Ltd", "cf2": "gold" },
    "createdAt": "2026-06-24T09:00:00.000Z",
    "updatedAt": "2026-06-24T09:00:00.000Z"
  }
}

curl -X PATCH "https://motherbot.io/api/v1/contacts/664a1f..." \
  -H "Authorization: Bearer motherbot_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "tags": ["vip", "delhi"], "optedIn": false }'

{
  "success": true,
  "data": {
    "_id": "664a1f...",
    "name": "Priya Sharma",
    "tags": ["vip", "delhi"],
    "optedIn": false,
    "updatedAt": "2026-06-24T10:00:00.000Z"
  }
}

curl -X DELETE "https://motherbot.io/api/v1/contacts/664a1f..." \
  -H "Authorization: Bearer motherbot_xxx"

{
  "success": true,
  "message": "Contact deleted"
}

curl "https://motherbot.io/api/v1/messages?direction=outbound&status=failed&limit=50" \
  -H "Authorization: Bearer motherbot_xxx"

{
  "success": true,
  "data": [
    {
      "_id": "6650...",
      "contact": "6650f1a2b3c4d5e6f7a8b9c0",
      "waId": "919876543210",
      "direction": "outbound",
      "type": "template",
      "status": "delivered",
      "source": "campaign",
      "wamid": "wamid.HBgM...",
      "timestamp": "2026-07-23T09:14:02.000Z",
      "sentAt": "2026-07-23T09:14:02.000Z",
      "deliveredAt": "2026-07-23T09:14:05.000Z"
    }
  ],
  "pagination": { "page": 1, "limit": 50, "total": 1482, "pages": 30 }
}

# Text message
curl -X POST "https://motherbot.io/api/v1/messages" \
  -H "Authorization: Bearer motherbot_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "919876543210",
    "type": "text",
    "text": { "body": "Hello! Your order has shipped." }
  }'

# Template message with body variables
curl -X POST "https://motherbot.io/api/v1/messages" \
  -H "Authorization: Bearer motherbot_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "919876543210",
    "type": "template",
    "template": {
      "name": "order_confirmation",
      "language": { "code": "en_US" },
      "components": [
        {
          "type": "body",
          "parameters": [
            { "type": "text", "text": "John" },
            { "type": "text", "text": "ORDER-9912" }
          ]
        }
      ]
    }
  }'

# Authentication (OTP) template — the code goes in the body only;
# the copy-code button parameter WhatsApp requires is added for you.
curl -X POST "https://motherbot.io/api/v1/messages" \
  -H "Authorization: Bearer motherbot_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "919876543210",
    "type": "template",
    "template": {
      "name": "otp_login",
      "language": { "code": "en" },
      "components": [
        { "type": "body", "parameters": [{ "type": "text", "text": "483920" }] }
      ]
    }
  }'

# Template with a DYNAMIC header — this customer's own invoice, not a shared banner.
# Send values, not a components array: the payload is built from the approved
# definition, so you don't need to know whether the header is IMAGE or TEXT.
curl -X POST "https://motherbot.io/api/v1/messages" \
  -H "Authorization: Bearer motherbot_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "919876543210",
    "type": "template",
    "template": {
      "name": "invoice_ready",
      "language": { "code": "en_US" },
      "headerMediaUrl": "https://cdn.mystore.com/invoices/9912.pdf",
      "variables": { "1": "Priya", "2": "ORDER-9912" },
      "buttonVariablesByIndex": { "0": "TRACK-9912" }
    }
  }'

# A TEXT header's {{1}} is dynamic the same way
curl -X POST "https://motherbot.io/api/v1/messages" \
  -H "Authorization: Bearer motherbot_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "919876543210",
    "type": "template",
    "template": {
      "name": "ticket_update",
      "language": { "code": "en_US" },
      "headerVariables": ["#9912"],
      "variables": ["Priya"]
    }
  }'

# From a SPECIFIC number — accountId comes from GET /api/v1/channels
curl -X POST "https://motherbot.io/api/v1/messages" \
  -H "Authorization: Bearer motherbot_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "919876543210",
    "accountId": "66f1c2a0d3b4e5f6a7b8c9d0",
    "type": "text",
    "text": { "body": "Sent from our support number." }
  }'

# Video with a caption (image, audio and document take the same shape)
curl -X POST "https://motherbot.io/api/v1/messages" \
  -H "Authorization: Bearer motherbot_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "919876543210",
    "type": "video",
    "video": {
      "link": "https://cdn.example.com/a.mp4",
      "caption": "Your video is ready"
    }
  }'

# Reply buttons, with a video header
curl -X POST "https://motherbot.io/api/v1/messages" \
  -H "Authorization: Bearer motherbot_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "919876543210",
    "type": "interactive",
    "interactive": {
      "type": "button",
      "header": { "type": "video", "video": { "link": "https://cdn.example.com/a.mp4" } },
      "body":   { "text": "Your video is ready, Priya." },
      "footer": { "text": "Acme Retail" },
      "action": {
        "buttons": [
          { "id": "yes", "title": "Book a call" },
          { "id": "no",  "title": "Not now" }
        ]
      }
    }
  }'

# List picker — at most 10 sections, and 10 rows across all of them
curl -X POST "https://motherbot.io/api/v1/messages" \
  -H "Authorization: Bearer motherbot_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "919876543210",
    "type": "interactive",
    "interactive": {
      "type": "list",
      "body": { "text": "Pick a slot" },
      "action": {
        "button": "Choose",
        "sections": [
          {
            "title": "Tomorrow",
            "rows": [ { "id": "10", "title": "10:00", "description": "45 min" } ]
          }
        ]
      }
    }
  }'

# URL button
curl -X POST "https://motherbot.io/api/v1/messages" \
  -H "Authorization: Bearer motherbot_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "919876543210",
    "type": "interactive",
    "interactive": {
      "type": "cta_url",
      "body": { "text": "Your video is ready" },
      "action": { "displayText": "Watch it", "url": "https://cdn.example.com/a.mp4" }
    }
  }'

# Another channel entirely — Telegram (chat id as 'to'), and email
curl -X POST "https://motherbot.io/api/v1/messages" \
  -H "Authorization: Bearer motherbot_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "5551234567",
    "channel": "telegram",
    "type": "text",
    "text": { "body": "Your order has shipped." }
  }'

curl -X POST "https://motherbot.io/api/v1/messages" \
  -H "Authorization: Bearer motherbot_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "priya@example.com",
    "channel": "email",
    "subject": "Your order has shipped",
    "text": { "body": "Tracking: ABC123" }
  }'

{
  "success": true,
  "data": {
    "messageId": "wamid.HBgNOTE5...",
    "to": "919876543210",
    "status": "sent",
    "channel": "whatsapp",
    "accountId": "66f1c2a0d3b4e5f6a7b8c9d0",
    "contactId": "6650f1a2b3c4d5e6f7a8b9c0",
    "contactCreated": false
  }
}

curl -X POST "https://motherbot.io/api/v1/messages/bulk" \
  -H "Authorization: Bearer motherbot_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "templateName": "order_confirmation",
    "languageCode": "en_US",
    "headerVariables": ["https://cdn.mystore.com/banner.jpg"],
    "buttonVariables": ["https://track.mystore.com/orders/"],
    "recipients": [
      {
        "to": "919876543210",
        "variables": { "1": "John", "2": "ORDER-9912", "3": "₹599" }
      },
      {
        "to": "918765432109",
        "variables": { "1": "Priya", "2": "ORDER-9913", "3": "₹299" }
      }
    ]
  }'

// 250 recipients or fewer — sent inline (HTTP 207)
{
  "success": true,
  "mode": "sync",
  "channel": "whatsapp",
  "accountId": "66f1c2a0d3b4e5f6a7b8c9d0",
  "summary": {
    "total": 3,
    "sent": 2,
    "failed": 0,
    "skipped": 1
  },
  "results": [
    { "to": "919876543210", "status": "sent",    "messageId": "wamid.AAA..." },
    { "to": "918765432109", "status": "sent",    "messageId": "wamid.BBB..." },
    { "to": "910000000000", "status": "skipped", "error": "Contact has opted out" }
  ]
}

// More than 250 — accepted and queued (HTTP 202), back in milliseconds
{
  "success": true,
  "mode": "async",
  "channel": "whatsapp",
  "accountId": "66f1c2a0d3b4e5f6a7b8c9d0",
  "batchId": "66a2b1c0d3b4e5f6a7b8c9d0",
  "status": "queued",
  "statusUrl": "/api/v1/messages/bulk/66a2b1c0d3b4e5f6a7b8c9d0",
  "summary": { "total": 10000, "queued": 9987, "skipped": 13 },
  "results": [
    { "to": "910000000000", "status": "skipped", "error": "Contact has opted out" }
  ],
  "rateLimitPerSecond": 10,
  "etaSeconds": 999,
  "etaText": "~17 minutes"
}

curl "https://motherbot.io/api/v1/messages/bulk/66a2b1c0d3b4e5f6a7b8c9d0" \
  -H "Authorization: Bearer motherbot_xxx"

# Just the ones that failed
curl "https://motherbot.io/api/v1/messages/bulk/66a2b1c0d3b4e5f6a7b8c9d0?status=failed&limit=1000" \
  -H "Authorization: Bearer motherbot_xxx"

{
  "success": true,
  "data": {
    "batchId": "66a2b1c0d3b4e5f6a7b8c9d0",
    "status": "running",
    "accountId": "66f1c2a0d3b4e5f6a7b8c9d0",
    "summary": {
      "total": 9987, "queued": 4102, "sent": 5885,
      "delivered": 5210, "read": 3840, "failed": 0
    },
    "rateLimitPerSecond": 10,
    "etaSeconds": 410,
    "startedAt": "2026-08-16T09:00:00.000Z",
    "completedAt": null,
    "recipients": [
      {
        "to": "919876543210",
        "name": "Priya Sharma",
        "status": "read",
        "messageId": "wamid.AAA...",
        "sentAt": "2026-08-16T09:00:01.000Z",
        "deliveredAt": "2026-08-16T09:00:03.000Z",
        "readAt": "2026-08-16T09:04:11.000Z"
      }
    ]
  },
  "pagination": { "page": 1, "limit": 100, "total": 9987, "pages": 100 }
}

curl "https://motherbot.io/api/v1/templates?status=APPROVED&category=MARKETING" \
  -H "Authorization: Bearer motherbot_xxx"

# Only the templates for one number
curl "https://motherbot.io/api/v1/templates?accountId=66f1c2a0d3b4e5f6a7b8c9d0&status=APPROVED" \
  -H "Authorization: Bearer motherbot_xxx"

{
  "success": true,
  "data": [
    {
      "_id": "665b2a...",
      "accountId": "66f1c2a0d3b4e5f6a7b8c9d0",
      "metaTemplateId": "1234567890",
      "name": "order_confirmation",
      "category": "MARKETING",
      "language": "en_US",
      "status": "APPROVED",
      "variables": ["customer_name", "order_id", "amount"],
      "usageCount": 4821,
      "components": [
        { "type": "HEADER", "format": "IMAGE" },
        { "type": "BODY",   "text": "Hi {{1}}, your order {{2}} of {{3}} is confirmed!" },
        { "type": "FOOTER", "text": "Reply STOP to unsubscribe" },
        {
          "type": "BUTTONS",
          "buttons": [{ "type": "URL", "text": "Track Order", "url": "https://mystore.com/track/{{1}}" }]
        }
      ],
      "createdAt": "2026-04-10T08:00:00.000Z",
      "updatedAt": "2026-06-01T12:00:00.000Z"
    }
  ],
  "pagination": { "page": 1, "limit": 20, "total": 12, "pages": 1 }
}

curl "https://motherbot.io/api/v1/campaigns?status=completed" \
  -H "Authorization: Bearer motherbot_xxx"

{
  "success": true,
  "data": [
    {
      "_id": "665c3b...",
      "name": "June Sale Blast",
      "status": "completed",
      "audienceType": "all",
      "audienceCount": 9800,
      "template": { "_id": "665b2a...", "name": "order_confirmation", "category": "MARKETING" },
      "stats": {
        "total": 9800, "sent": 9750, "delivered": 9600,
        "read": 7200, "failed": 50, "replied": 320
      },
      "startedAt": "2026-06-01T09:00:01.000Z",
      "completedAt": "2026-06-01T09:14:22.000Z"
    }
  ],
  "pagination": { "page": 1, "limit": 20, "total": 1, "pages": 1 }
}

curl -X POST "https://motherbot.io/api/v1/campaigns" \
  -H "Authorization: Bearer motherbot_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Diwali Offer 2026",
    "templateId": "665b2a...",
    "audienceType": "tags",
    "audienceTags": ["opted-in", "delhi"],
    "scheduledAt": "2026-10-20 09:00:00"
  }'

{
  "success": true,
  "data": {
    "_id": "665d4c...",
    "name": "Diwali Offer 2026",
    "status": "scheduled",
    "audienceType": "tags",
    "audienceTags": ["opted-in", "delhi"],
    "audienceCount": 3200,
    "scheduledAt": "2026-10-20T09:00:00.000Z",
    "stats": { "total": 3200, "sent": 0, "delivered": 0, "read": 0, "failed": 0 },
    "createdAt": "2026-06-24T10:30:00.000Z"
  }
}

curl -X POST "https://motherbot.io/api/v1/campaigns/send" \
  -H "Authorization: Bearer motherbot_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "June Order Dispatch",
    "templateName": "order_confirmation",
    "languageCode": "en_US",
    "commonVariables": {
      "1": "MotherBot Store",
      "3": "support@mystore.com"
    },
    "headerMediaUrl": "https://cdn.mystore.com/banner.jpg",
    "rateLimitPerSecond": 10,
    "recipients": [
      {
        "to": "919876543210",
        "name": "John Smith",
        "variables": { "2": "ORDER-9912" }
      },
      {
        "to": "918765432109",
        "name": "Priya Sharma",
        "variables": { "2": "ORDER-9913" }
      },
      {
        "to": "917654321098",
        "name": "Ravi Kumar"
      }
    ]
  }'

{
  "success": true,
  "data": {
    "campaignId": "665d4c...",
    "status": "running",
    "total": 3,
    "channel": "whatsapp",
    "accountId": "66f1c2a0d3b4e5f6a7b8c9d0",
    "rateLimitPerSecond": 10,
    "etaSeconds": 1,
    "etaText": "~1 second"
  }
}

curl "https://motherbot.io/api/v1/campaigns/665c3b.../stats" \
  -H "Authorization: Bearer motherbot_xxx"

{
  "success": true,
  "data": {
    "_id": "665c3b...",
    "name": "June Sale Blast",
    "status": "completed",
    "source": "api",
    "audienceCount": 9800,
    "stats": {
      "total": 9800, "queued": 0, "sent": 9750,
      "delivered": 9600, "read": 7200,
      "failed": 50, "replied": 320, "clicked": 480, "optedOut": 12
    },
    "cost": {
      "pricePerConversation": 0.78,
      "billableCount": 9750,
      "estimatedCost": 7605.00,
      "currency": "INR",
      "templateCategory": "MARKETING"
    },
    "startedAt": "2026-06-01T09:00:01.000Z",
    "completedAt": "2026-06-01T09:14:22.000Z"
  }
}

curl -X POST "https://motherbot.io/api/v1/campaigns/665c3b.../pause" \
  -H "Authorization: Bearer motherbot_xxx"

{
  "success": true,
  "data": { "id": "665c3b...", "status": "paused" }
}

curl -X POST "https://motherbot.io/api/v1/campaigns/665c3b.../resume" \
  -H "Authorization: Bearer motherbot_xxx"

{
  "success": true,
  "data": { "id": "665c3b...", "status": "running" }
}

curl "https://motherbot.io/api/v1/segments?count=1" \
  -H "Authorization: Bearer motherbot_xxx"

{
  "success": true,
  "data": [
    {
      "id": "6651a...",
      "name": "Lapsed buyers",
      "description": "No order in 90 days",
      "match": "all",
      "ruleCount": 3,
      "count": 412,
      "updatedAt": "2026-07-20T11:02:00.000Z"
    }
  ]
}

curl "https://motherbot.io/api/v1/sequences" \
  -H "Authorization: Bearer motherbot_xxx"

{
  "success": true,
  "data": [
    { "id": "6653d...", "name": "Trial nudges", "status": "active", "stepCount": 3,
      "stats": { "enrolled": 420, "completed": 180, "exited": 60, "sent": 940, "failed": 2 } }
  ]
}

curl -X POST "https://motherbot.io/api/v1/sequences" \
  -H "Authorization: Bearer motherbot_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Trial nudges",
    "whatsappAccountId": "6640a...",
    "entry": { "type": "manual" },
    "steps": [
      { "templateId": "6642b...", "delayValue": 0, "delayUnit": "minutes",
        "templateVariableMapping": { "1": "{{contact.firstName}}" } },
      { "templateId": "6642c...", "delayValue": 2, "delayUnit": "days",
        "templateVariableMapping": { "1": "{{contact.firstName}}", "2": "TRIAL20" } }
    ],
    "stopOnReply": true
  }'

{
  "success": true,
  "data": { "id": "6653d...", "status": "draft" }
}

curl -X POST "https://motherbot.io/api/v1/sequences/6653d.../enroll" \
  -H "Authorization: Bearer motherbot_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "tag": "trial" }'

{
  "success": true,
  "data": { "enrolled": 128, "skipped": 12 }
}

curl "https://motherbot.io/api/v1/sequences/6653d.../enrollments?status=failed" \
  -H "Authorization: Bearer motherbot_xxx"

{
  "success": true,
  "data": {
    "totalSteps": 3,
    "rows": [
      { "contactId": "6650...", "name": "Priya", "phone": "+919876543210",
        "status": "active", "step": 2, "totalSteps": 3, "sentCount": 1,
        "nextRunAt": "2026-07-25T09:00:00.000Z" }
    ]
  }
}

curl "https://motherbot.io/api/v1/coupons" \
  -H "Authorization: Bearer motherbot_xxx"

{
  "success": true,
  "data": [
    { "_id": "6654e...", "name": "Diwali 25", "kind": "shared", "code": "DIWALI25",
      "discountType": "percent", "discountValue": 25,
      "issuedCount": 380, "redeemedCount": 112, "isActive": true }
  ]
}

curl -X POST "https://motherbot.io/api/v1/coupons" \
  -H "Authorization: Bearer motherbot_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Diwali 25", "kind": "shared", "code": "DIWALI25",
        "discountType": "percent", "discountValue": 25, "maxPerContact": 1 }'

{
  "success": true,
  "data": { "id": "6654e...", "name": "Diwali 25", "kind": "shared", "code": "DIWALI25" }
}

curl -X POST "https://motherbot.io/api/v1/coupons/6654e.../send" \
  -H "Authorization: Bearer motherbot_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "segmentId": "6651a...", "templateName": "diwali_offer",
        "codeVarIndex": 2, "variables": { "1": "{{contact.firstName}}" } }'

{
  "success": true,
  "data": { "sent": 380, "failed": 2, "skipped": 0, "total": 382 }
}

curl -X POST "https://motherbot.io/api/v1/coupons/6654e.../sync" \
  -H "Authorization: Bearer motherbot_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "action": "sync" }'

{
  "success": true,
  "data": { "externalId": "gid://shopify/DiscountCodeNode/14...", "code": "DIWALI25", "adopted": false }
}

curl "https://motherbot.io/api/v1/coupons/6654e.../redemptions?limit=200" \
  -H "Authorization: Bearer motherbot_xxx"

{
  "success": true,
  "data": [
    {
      "_id": "6712aa...",
      "code": "DIWALI25",
      "reference": "order_10482",
      "orderNumber": "#10482",
      "source": "shopify",
      "amount": 2499,
      "currency": "INR",
      "contactId": "664a1f...",
      "contactName": "Priya Sharma",
      "waId": "919876543210",
      "redeemedAt": "2026-07-11T14:20:31.000Z"
    }
  ]
}

curl -X POST "https://motherbot.io/api/v1/coupons/redeem" \
  -H "Authorization: Bearer motherbot_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "code": "DIWALI25", "contactId": "6650...", "reference": "order_10482" }'

{
  "success": true,
  "data": { "couponId": "6654e...", "discountType": "percent", "discountValue": 25 }
}

curl "https://motherbot.io/api/v1/links" \
  -H "Authorization: Bearer motherbot_xxx"

{
  "success": true,
  "data": [
    { "_id": "6655f...", "name": "Diwali poster", "kind": "whatsapp",
      "url": "https://motherbot.io/r/diwali-poster-a7k2", "refCode": "A7K2",
      "clicks": 1840, "uniqueClicks": 1502, "conversations": 311, "isActive": true }
  ]
}

curl -X POST "https://motherbot.io/api/v1/links" \
  -H "Authorization: Bearer motherbot_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Diwali poster", "kind": "whatsapp",
        "whatsappAccountId": "6640a...", "prefillText": "Hi! I saw the Diwali poster." }'

{
  "success": true,
  "data": { "_id": "6655f...", "slug": "diwali-poster-a7k2",
            "url": "https://motherbot.io/r/diwali-poster-a7k2", "refCode": "A7K2" }
}

curl "https://motherbot.io/api/v1/pipelines" \
  -H "Authorization: Bearer motherbot_xxx"

{
  "success": true,
  "data": [
    { "id": "66f0a...", "name": "Sales", "currency": "INR", "isDefault": true,
      "stages": [
        { "key": "new", "name": "New", "order": 0, "isWon": false, "isLost": false },
        { "key": "won", "name": "Won", "order": 4, "isWon": true, "isLost": false }
      ] }
  ]
}

curl "https://motherbot.io/api/v1/deals?status=open&limit=50" \
  -H "Authorization: Bearer motherbot_xxx"

{
  "success": true,
  "data": [
    { "id": "670c1...", "title": "Bulk order — 200 units", "value": 48000, "currency": "INR",
      "pipelineId": "66f0a...", "stage": "qualified", "status": "open",
      "contact": { "id": "664a1...", "name": "Asha Patel", "waId": "919406537037" },
      "ageInStage": 3 }
  ],
  "pagination": { "page": 1, "limit": 50, "total": 12, "pages": 1 }
}

curl -X POST "https://motherbot.io/api/v1/deals" \
  -H "Authorization: Bearer motherbot_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "contactId": "664a1...", "title": "Bulk order — 200 units",
        "value": 48000, "stage": "qualified" }'

{ "success": true, "data": { "id": "670c1...", "stage": "qualified", "status": "open" } }

curl "https://motherbot.io/api/v1/deals/670c11..." \
  -H "Authorization: Bearer motherbot_xxx"

{
  "success": true,
  "data": {
    "id": "670c11...",
    "title": "Bulk order — 200 units",
    "value": 48000,
    "currency": "INR",
    "stage": "qualified",
    "status": "open",
    "contactId": "664a1f...",
    "contactName": "Priya Sharma",
    "ownerName": "Ankit",
    "expectedCloseAt": "2026-08-15T00:00:00.000Z",
    "updatedAt": "2026-07-20T11:02:00.000Z"
  }
}

curl -X PATCH "https://motherbot.io/api/v1/deals/670c11..." \
  -H "Authorization: Bearer motherbot_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "status": "won" }'

{ "success": true, "data": { "id": "670c1...", "stage": "won", "status": "won" } }

curl -X DELETE "https://motherbot.io/api/v1/deals/670c11..." \
  -H "Authorization: Bearer motherbot_xxx"

{ "success": true, "data": { "id": "670c11...", "deleted": true } }

curl "https://motherbot.io/api/v1/products?inStock=true" \
  -H "Authorization: Bearer motherbot_xxx"

{
  "success": true,
  "data": [
    { "id": "670d4...", "name": "Cotton Kurta", "retailerId": "SKU-1182",
      "price": 1299, "currency": "INR", "inStock": true, "metaProductId": "78214..." }
  ],
  "pagination": { "page": 1, "limit": 20, "total": 84, "pages": 5 }
}

curl -X POST "https://motherbot.io/api/v1/products" \
  -H "Authorization: Bearer motherbot_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Cotton Kurta", "retailerId": "SKU-1182", "price": 1299, "inStock": true }'

{
  "success": true,
  "data": { "id": "670d4...", "retailerId": "SKU-1182", "metaProductId": null },
  "metaSync": { "synced": false, "error": "No catalogue configured" }
}

curl "https://motherbot.io/api/v1/products/670d4a..." \
  -H "Authorization: Bearer motherbot_xxx"

{
  "success": true,
  "data": {
    "id": "670d4a...",
    "name": "Cotton Kurta",
    "retailerId": "SKU-1182",
    "price": 1299,
    "salePrice": null,
    "currency": "INR",
    "inStock": true,
    "status": "active",
    "metaProductId": "7712994...",
    "updatedAt": "2026-07-02T06:41:00.000Z"
  }
}

curl -X PATCH "https://motherbot.io/api/v1/products/670d4a..." \
  -H "Authorization: Bearer motherbot_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "price": 1149, "inStock": false }'

{ "success": true, "data": { "id": "670d4...", "price": 1149, "inStock": false },
  "metaSync": { "synced": true } }

curl -X DELETE "https://motherbot.io/api/v1/products/670d4a..." \
  -H "Authorization: Bearer motherbot_xxx"

{ "success": true, "data": { "id": "670d4a...", "deleted": true } }

curl -X POST "https://motherbot.io/api/v1/media" \
  -H "Authorization: Bearer motherbot_xxx" \
  -F "file=@invoice.pdf"

{
  "success": true,
  "data": { "url": "https://cdn.motherbot.io/.../invoice.pdf",
            "mediaType": "document", "mimeType": "application/pdf",
            "filename": "invoice.pdf", "bytes": 148213, "storage": "s3" }
}

curl "https://motherbot.io/api/v1/number-health" \
  -H "Authorization: Bearer motherbot_xxx"

{
  "success": true,
  "data": [
    { "accountId": "66aa1...", "phoneNumber": "+91 94065 37037", "status": "connected",
      "health": { "score": 78, "level": "caution", "qualityRating": "YELLOW",
                  "dailyCap": 10000, "usedToday": 2140, "remainingToday": 7860,
                  "sevenDay": { "sent": 9310, "delivered": 8994, "failed": 305,
                                "ruledOn": 9299, "deliveryRate": 0.967,
                                "blockRate": 0.0023, "optOutRate": 0.0004 },
                  "sendingPaused": null,
                  "factors": ["Meta has rated this number YELLOW …"] } }
  ]
}

curl "https://motherbot.io/api/v1/webhooks" \
  -H "Authorization: Bearer motherbot_xxx"

{
  "success": true,
  "data": [
    { "id": "671aa...", "name": "Order sync", "url": "https://example.com/hooks/motherbot",
      "events": ["message.received"], "isActive": true,
      "stats": { "delivered": 8421, "failed": 3, "lastDeliveredAt": "2026-07-27T09:11:04Z" } }
  ],
  "events": ["message.received", "message.sent", "..."]
}

curl -X POST "https://motherbot.io/api/v1/webhooks" \
  -H "Authorization: Bearer motherbot_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://example.com/hooks/motherbot",
        "events": ["message.received", "message.failed"] }'

{
  "success": true,
  "data": { "id": "671aa...", "url": "https://example.com/hooks/motherbot",
            "events": ["message.received", "message.failed"],
            "secret": "whsec_9f2c…", "isActive": true },
  "message": "Store the secret now — it is not returned again."
}

curl -X PATCH "https://motherbot.io/api/v1/webhooks/671aa2..." \
  -H "Authorization: Bearer motherbot_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "isActive": false }'

{ "success": true, "data": { "id": "671aa...", "isActive": false } }

curl -X DELETE "https://motherbot.io/api/v1/webhooks/671aa2..." \
  -H "Authorization: Bearer motherbot_xxx"

{ "success": true, "data": { "id": "671aa2...", "deleted": true } }

curl "https://motherbot.io/api/v1/usage" \
  -H "Authorization: Bearer motherbot_xxx"

{
  "success": true,
  "data": {
    "plan": { "name": "Growth", "subscriptionStatus": "active", "isActive": true },
    "rateLimit": { "perMinute": 300 },
    "limits": [
      { "key": "contacts", "label": "Contacts", "used": 8412, "limit": 25000,
        "unlimited": false, "remaining": 16588, "percentUsed": 34 }
    ],
    "features": { "salesPipeline": true, "numberHealthGuardian": true, "webChat": false },
    "integrations": ["shopify", "hubspot"]
  }
}

curl "https://motherbot.io/api/v1/catalog-orders?status=new" \
  -H "Authorization: Bearer motherbot_xxx"

{
  "success": true,
  "data": [
    { "id": "670c9f2...", "contactId": "664a1f8...", "totalValue": 1947, "currency": "INR",
      "status": "new", "items": [ { "productRetailerId": "sku-2201", "quantity": 2 } ] }
  ],
  "pagination": { "page": 1, "limit": 20, "total": 6, "pages": 1 }
}

curl "https://motherbot.io/api/v1/catalog-orders/670c9f2..." \
  -H "Authorization: Bearer motherbot_xxx"

{ "success": true, "data": { "id": "670c9f2...", "status": "new", "totalValue": 1947, "currency": "INR" } }

curl -X PATCH "https://motherbot.io/api/v1/catalog-orders/670c9f2..." \
  -H "Authorization: Bearer motherbot_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "status": "dismissed" }'

{ "success": true, "data": { "id": "670c9f2...", "status": "dismissed" } }

curl "https://motherbot.io/api/v1/recurring-campaigns" \
  -H "Authorization: Bearer motherbot_xxx"

{ "success": true, "data": [ { "_id": "670e1...", "name": "Weekly Digest", "status": "active",
  "trigger": { "type": "schedule", "frequency": "weekly", "dayOfWeek": 5, "time": "10:00", "timezone": "Asia/Kolkata" } } ] }

curl -X POST "https://motherbot.io/api/v1/recurring-campaigns" \
  -H "Authorization: Bearer motherbot_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Weekly Digest", "whatsappAccountId": "66aa1...", "templateId": "66f0a...",
        "audienceType": "all", "trigger": { "type": "schedule", "frequency": "weekly", "dayOfWeek": 5, "time": "10:00", "timezone": "Asia/Kolkata" } }'

{ "success": true, "data": { "_id": "670e1...", "name": "Weekly Digest", "status": "active" } }

curl "https://motherbot.io/api/v1/recurring-campaigns/670e1..." \
  -H "Authorization: Bearer motherbot_xxx"

{ "success": true, "data": { "_id": "670e1...", "name": "Weekly Digest", "totalRuns": 12, "totalRecipients": 38400 } }

curl -X PATCH "https://motherbot.io/api/v1/recurring-campaigns/670e1..." \
  -H "Authorization: Bearer motherbot_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "status": "paused" }'

{ "success": true, "data": { "_id": "670e1...", "status": "paused" } }

curl -X DELETE "https://motherbot.io/api/v1/recurring-campaigns/670e1..." \
  -H "Authorization: Bearer motherbot_xxx"

{ "success": true, "data": { "id": "670e1...", "deleted": true } }