{
  "info": {
    "name": "Wamator API",
    "description": "Complete Wamator WhatsApp Automation API — all endpoints with examples.\n\nSetup:\n1. Set the `base_url` variable to https://api.wamator.com\n2. Register as a vendor and copy your api_key\n3. Set the `api_key` collection variable\n4. Set other variables as you go (user_id, number_id, etc.)",
    "version": "2.0.0",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    { "key": "base_url", "value": "https://api.wamator.com", "type": "string" },
    { "key": "api_key", "value": "", "type": "string" },
    { "key": "user_id", "value": "", "type": "string" },
    { "key": "number_id", "value": "", "type": "string" },
    { "key": "contact_id", "value": "", "type": "string" },
    { "key": "list_id", "value": "", "type": "string" },
    { "key": "tag_id", "value": "", "type": "string" },
    { "key": "sequence_id", "value": "", "type": "string" },
    { "key": "enrollment_id", "value": "", "type": "string" },
    { "key": "batch_id", "value": "", "type": "string" },
    { "key": "plan_id", "value": "", "type": "string" }
  ],
  "item": [

    {
      "name": "1. Vendors",
      "item": [
        {
          "name": "Register vendor",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "url": { "raw": "{{base_url}}/vendors/register", "host": ["{{base_url}}"], "path": ["vendors", "register"] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Edumess\",\n  \"company_name\": \"Edumess Ltd\",\n  \"email\": \"admin@edumess.com\",\n  \"phone_number\": \"2348012345678\",\n  \"password\": \"YourPassword123!\"\n}"
            }
          }
        },
        {
          "name": "Login (get api_key)",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "url": { "raw": "{{base_url}}/vendors/login", "host": ["{{base_url}}"], "path": ["vendors", "login"] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"email\": \"admin@edumess.com\",\n  \"password\": \"YourPassword123!\"\n}"
            }
          }
        },
        {
          "name": "Update profile",
          "request": {
            "method": "PUT",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/vendors/update", "host": ["{{base_url}}"], "path": ["vendors", "update"] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Edumess Africa\"\n}"
            }
          }
        },
        {
          "name": "Register webhook",
          "request": {
            "method": "PATCH",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/vendors/webhook", "host": ["{{base_url}}"], "path": ["vendors", "webhook"] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"url\": \"https://edumess.com/api/wamator-events\",\n  \"secret\": \"your-signing-secret\",\n  \"events\": [\n    \"message.sent\",\n    \"message.delivered\",\n    \"message.failed\",\n    \"contact.opted_out\",\n    \"enrollment.completed\",\n    \"number.unhealthy\"\n  ]\n}"
            }
          }
        },
        {
          "name": "Get webhook config",
          "request": {
            "method": "GET",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/vendors/webhook", "host": ["{{base_url}}"], "path": ["vendors", "webhook"] }
          }
        },
        {
          "name": "Webhook delivery logs",
          "request": {
            "method": "GET",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/vendors/webhook/logs?page=1&limit=20", "host": ["{{base_url}}"], "path": ["vendors", "webhook", "logs"], "query": [{ "key": "page", "value": "1" }, { "key": "limit", "value": "20" }] }
          }
        },
        {
          "name": "Disable webhook",
          "request": {
            "method": "DELETE",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/vendors/webhook", "host": ["{{base_url}}"], "path": ["vendors", "webhook"] }
          }
        }
      ]
    },

    {
      "name": "2. Plans",
      "item": [
        {
          "name": "List all plans",
          "request": {
            "method": "GET",
            "url": { "raw": "{{base_url}}/plans/", "host": ["{{base_url}}"], "path": ["plans", ""] }
          }
        },
        {
          "name": "Get single plan",
          "request": {
            "method": "GET",
            "url": { "raw": "{{base_url}}/plans/{{plan_id}}", "host": ["{{base_url}}"], "path": ["plans", "{{plan_id}}"] }
          }
        }
      ]
    },

    {
      "name": "3. Subscriptions",
      "item": [
        {
          "name": "Subscribe to plan",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/subscriptions/subscribe", "host": ["{{base_url}}"], "path": ["subscriptions", "subscribe"] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"plan_id\": \"{{plan_id}}\"\n}"
            }
          }
        },
        {
          "name": "Current subscription + usage",
          "request": {
            "method": "GET",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/subscriptions/current", "host": ["{{base_url}}"], "path": ["subscriptions", "current"] }
          }
        },
        {
          "name": "Subscription history",
          "request": {
            "method": "GET",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/subscriptions/history", "host": ["{{base_url}}"], "path": ["subscriptions", "history"] }
          }
        }
      ]
    },

    {
      "name": "4. Sub-Users",
      "item": [
        {
          "name": "Register user",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/users/register", "host": ["{{base_url}}"], "path": ["users", "register"] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Funcare School\",\n  \"company_name\": \"Funcare International\",\n  \"email\": \"admin@funcare.com\",\n  \"external_id\": \"school_001\"\n}"
            }
          }
        },
        {
          "name": "List users",
          "request": {
            "method": "GET",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/users/list", "host": ["{{base_url}}"], "path": ["users", "list"] }
          }
        },
        {
          "name": "Get user",
          "request": {
            "method": "GET",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/users/{{user_id}}", "host": ["{{base_url}}"], "path": ["users", "{{user_id}}"] }
          }
        },
        {
          "name": "Update user",
          "request": {
            "method": "PATCH",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/users/{{user_id}}", "host": ["{{base_url}}"], "path": ["users", "{{user_id}}"] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Funcare Academy\"\n}"
            }
          }
        },
        {
          "name": "Delete user",
          "request": {
            "method": "DELETE",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/users/{{user_id}}", "host": ["{{base_url}}"], "path": ["users", "{{user_id}}"] }
          }
        }
      ]
    },

    {
      "name": "5. WhatsApp Numbers",
      "item": [
        {
          "name": "Add number",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/numbers/", "host": ["{{base_url}}"], "path": ["numbers", ""] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"user_id\": \"{{user_id}}\",\n  \"phone_number\": \"2349063570004\",\n  \"label\": \"Funcare Main Line\"\n}"
            }
          }
        },
        {
          "name": "Connect number (get QR)",
          "request": {
            "method": "POST",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/numbers/{{number_id}}/connect", "host": ["{{base_url}}"], "path": ["numbers", "{{number_id}}", "connect"] }
          }
        },
        {
          "name": "Check connection status",
          "request": {
            "method": "GET",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/numbers/{{number_id}}/status", "host": ["{{base_url}}"], "path": ["numbers", "{{number_id}}", "status"] }
          }
        },
        {
          "name": "Number health",
          "request": {
            "method": "GET",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/numbers/{{number_id}}/health", "host": ["{{base_url}}"], "path": ["numbers", "{{number_id}}", "health"] }
          }
        },
        {
          "name": "Toggle warm-up (enable)",
          "request": {
            "method": "PATCH",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/numbers/{{number_id}}/warmup?enabled=true", "host": ["{{base_url}}"], "path": ["numbers", "{{number_id}}", "warmup"], "query": [{ "key": "enabled", "value": "true" }] }
          }
        },
        {
          "name": "Toggle warm-up (disable)",
          "request": {
            "method": "PATCH",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/numbers/{{number_id}}/warmup?enabled=false", "host": ["{{base_url}}"], "path": ["numbers", "{{number_id}}", "warmup"], "query": [{ "key": "enabled", "value": "false" }] }
          }
        },
        {
          "name": "List all numbers",
          "request": {
            "method": "GET",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/numbers/", "host": ["{{base_url}}"], "path": ["numbers", ""] }
          }
        },
        {
          "name": "Delete number",
          "request": {
            "method": "DELETE",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/numbers/{{number_id}}", "host": ["{{base_url}}"], "path": ["numbers", "{{number_id}}"] }
          }
        }
      ]
    },

    {
      "name": "6. Contacts",
      "item": [
        {
          "name": "Bulk import contacts",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/contacts/bulk", "host": ["{{base_url}}"], "path": ["contacts", "bulk"] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"contacts\": [\n    {\n      \"user_id\": \"{{user_id}}\",\n      \"phone_number\": \"2348012345678\",\n      \"name\": \"Mrs. Adaeze Obi\",\n      \"email\": \"adaeze@gmail.com\",\n      \"city\": \"Lagos\",\n      \"gender\": \"female\",\n      \"customer_tier\": \"gold\",\n      \"timezone\": \"Africa/Lagos\",\n      \"message_opt_in\": true\n    },\n    {\n      \"user_id\": \"{{user_id}}\",\n      \"phone_number\": \"2348099999999\",\n      \"name\": \"Mr. Emeka Eze\",\n      \"city\": \"Abuja\",\n      \"message_opt_in\": true\n    }\n  ]\n}"
            }
          }
        },
        {
          "name": "List contacts",
          "request": {
            "method": "GET",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/contacts/?user_id={{user_id}}&page=1&limit=50", "host": ["{{base_url}}"], "path": ["contacts", ""], "query": [{ "key": "user_id", "value": "{{user_id}}" }, { "key": "page", "value": "1" }, { "key": "limit", "value": "50" }] }
          }
        },
        {
          "name": "Get contact",
          "request": {
            "method": "GET",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/contacts/{{contact_id}}", "host": ["{{base_url}}"], "path": ["contacts", "{{contact_id}}"] }
          }
        },
        {
          "name": "Update contact",
          "request": {
            "method": "PATCH",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/contacts/{{contact_id}}", "host": ["{{base_url}}"], "path": ["contacts", "{{contact_id}}"] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"updates\": {\n    \"customer_tier\": \"vip\",\n    \"city\": \"Abuja\"\n  }\n}"
            }
          }
        },
        {
          "name": "Delete contact",
          "request": {
            "method": "DELETE",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/contacts/{{contact_id}}", "host": ["{{base_url}}"], "path": ["contacts", "{{contact_id}}"] }
          }
        }
      ]
    },

    {
      "name": "7. Messages",
      "item": [
        {
          "name": "Blast to all contacts",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/messages/blast", "host": ["{{base_url}}"], "path": ["messages", "blast"] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"user_id\": \"{{user_id}}\",\n  \"phone_number_id\": \"{{number_id}}\",\n  \"template\": \"Hello {{name}}, fees for this term are due Friday. Thank you — Funcare School.\"\n}"
            }
          }
        },
        {
          "name": "Blast to selected contacts",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/messages/blast", "host": ["{{base_url}}"], "path": ["messages", "blast"] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"user_id\": \"{{user_id}}\",\n  \"phone_number_id\": \"{{number_id}}\",\n  \"template\": \"Hi {{name}}, your VIP discount is live!\",\n  \"contact_ids\": [\"contact-uuid-1\", \"contact-uuid-2\"]\n}"
            }
          }
        },
        {
          "name": "Send single text",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/messages/send", "host": ["{{base_url}}"], "path": ["messages", "send"] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"phone_number_id\": \"{{number_id}}\",\n  \"to\": \"2348012345678\",\n  \"text\": \"Hello! Your invoice is ready.\"\n}"
            }
          }
        },
        {
          "name": "Send image",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/messages/send-image", "host": ["{{base_url}}"], "path": ["messages", "send-image"] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"phone_number_id\": \"{{number_id}}\",\n  \"to\": \"2348012345678\",\n  \"url\": \"https://example.com/image.jpg\",\n  \"caption\": \"Check this out!\"\n}"
            }
          }
        },
        {
          "name": "Send video",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/messages/send-video", "host": ["{{base_url}}"], "path": ["messages", "send-video"] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"phone_number_id\": \"{{number_id}}\",\n  \"to\": \"2348012345678\",\n  \"url\": \"https://example.com/video.mp4\",\n  \"caption\": \"Watch this!\"\n}"
            }
          }
        },
        {
          "name": "Send audio",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/messages/send-audio", "host": ["{{base_url}}"], "path": ["messages", "send-audio"] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"phone_number_id\": \"{{number_id}}\",\n  \"to\": \"2348012345678\",\n  \"url\": \"https://example.com/audio.mp3\"\n}"
            }
          }
        },
        {
          "name": "Send document",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/messages/send-document", "host": ["{{base_url}}"], "path": ["messages", "send-document"] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"phone_number_id\": \"{{number_id}}\",\n  \"to\": \"2348012345678\",\n  \"url\": \"https://example.com/invoice.pdf\",\n  \"caption\": \"Your invoice is attached.\"\n}"
            }
          }
        },
        {
          "name": "Send buttons",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/messages/send-buttons", "host": ["{{base_url}}"], "path": ["messages", "send-buttons"] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"phone_number_id\": \"{{number_id}}\",\n  \"to\": \"2348012345678\",\n  \"body\": \"How would you like to pay?\",\n  \"buttons\": [\n    { \"id\": \"pay_transfer\", \"text\": \"Bank Transfer\" },\n    { \"id\": \"pay_card\", \"text\": \"Card\" },\n    { \"id\": \"pay_later\", \"text\": \"Pay Later\" }\n  ]\n}"
            }
          }
        },
        {
          "name": "Send list message",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/messages/send-list", "host": ["{{base_url}}"], "path": ["messages", "send-list"] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"phone_number_id\": \"{{number_id}}\",\n  \"to\": \"2348012345678\",\n  \"body\": \"Select a service:\",\n  \"button_text\": \"View Options\",\n  \"sections\": [\n    {\n      \"title\": \"Academic\",\n      \"rows\": [\n        { \"id\": \"s1\", \"title\": \"Fee Payment\", \"description\": \"Pay school fees\" },\n        { \"id\": \"s2\", \"title\": \"Results\", \"description\": \"Check exam results\" }\n      ]\n    }\n  ]\n}"
            }
          }
        },
        {
          "name": "Send location",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/messages/send-location", "host": ["{{base_url}}"], "path": ["messages", "send-location"] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"phone_number_id\": \"{{number_id}}\",\n  \"to\": \"2348012345678\",\n  \"latitude\": 6.5244,\n  \"longitude\": 3.3792,\n  \"name\": \"Funcare School\",\n  \"address\": \"12 Lekki Phase 1, Lagos\"\n}"
            }
          }
        },
        {
          "name": "React to message",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/messages/react", "host": ["{{base_url}}"], "path": ["messages", "react"] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"phone_number_id\": \"{{number_id}}\",\n  \"to\": \"2348012345678\",\n  \"message_id\": \"whatsapp-message-id\",\n  \"emoji\": \"👍\"\n}"
            }
          }
        },
        {
          "name": "Check if number is on WhatsApp",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/messages/check-number", "host": ["{{base_url}}"], "path": ["messages", "check-number"] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"phone_number_id\": \"{{number_id}}\",\n  \"number\": \"2348012345678\"\n}"
            }
          }
        },
        {
          "name": "Message logs",
          "request": {
            "method": "GET",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/messages/logs?batch_id={{batch_id}}&page=1&limit=50", "host": ["{{base_url}}"], "path": ["messages", "logs"], "query": [{ "key": "batch_id", "value": "{{batch_id}}" }, { "key": "page", "value": "1" }, { "key": "limit", "value": "50" }] }
          }
        }
      ]
    },

    {
      "name": "8. Groups",
      "item": [
        {
          "name": "Create group",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/groups/create", "host": ["{{base_url}}"], "path": ["groups", "create"] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"phone_number_id\": \"{{number_id}}\",\n  \"name\": \"Funcare Parents 2026\",\n  \"participants\": [\"2348012345678\", \"2348099999999\"]\n}"
            }
          }
        },
        {
          "name": "List groups",
          "request": {
            "method": "GET",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/groups/?phone_number_id={{number_id}}", "host": ["{{base_url}}"], "path": ["groups", ""], "query": [{ "key": "phone_number_id", "value": "{{number_id}}" }] }
          }
        },
        {
          "name": "Send text to group",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/groups/GROUP_ID@g.us/send-text", "host": ["{{base_url}}"], "path": ["groups", "GROUP_ID@g.us", "send-text"] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"phone_number_id\": \"{{number_id}}\",\n  \"text\": \"Reminder: PTA meeting tomorrow at 9am.\"\n}"
            }
          }
        },
        {
          "name": "Add participants",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/groups/GROUP_ID@g.us/participants/add", "host": ["{{base_url}}"], "path": ["groups", "GROUP_ID@g.us", "participants", "add"] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"phone_number_id\": \"{{number_id}}\",\n  \"participants\": [\"2348055555555\"]\n}"
            }
          }
        }
      ]
    },

    {
      "name": "9. Lists",
      "item": [
        {
          "name": "Create list",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/lists/", "host": ["{{base_url}}"], "path": ["lists", ""] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"user_id\": \"{{user_id}}\",\n  \"name\": \"School Owners\",\n  \"description\": \"All registered school owners on Edumess\"\n}"
            }
          }
        },
        {
          "name": "Get all lists",
          "request": {
            "method": "GET",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/lists/?user_id={{user_id}}", "host": ["{{base_url}}"], "path": ["lists", ""], "query": [{ "key": "user_id", "value": "{{user_id}}" }] }
          }
        },
        {
          "name": "Add contacts to list",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/lists/{{list_id}}/contacts", "host": ["{{base_url}}"], "path": ["lists", "{{list_id}}", "contacts"] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"contact_ids\": [\"{{contact_id}}\"]\n}"
            }
          }
        },
        {
          "name": "Get list contacts",
          "request": {
            "method": "GET",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/lists/{{list_id}}/contacts?page=1&limit=50", "host": ["{{base_url}}"], "path": ["lists", "{{list_id}}", "contacts"], "query": [{ "key": "page", "value": "1" }, { "key": "limit", "value": "50" }] }
          }
        },
        {
          "name": "Remove contacts from list",
          "request": {
            "method": "DELETE",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/lists/{{list_id}}/contacts", "host": ["{{base_url}}"], "path": ["lists", "{{list_id}}", "contacts"] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"contact_ids\": [\"{{contact_id}}\"]\n}"
            }
          }
        },
        {
          "name": "Delete list",
          "request": {
            "method": "DELETE",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/lists/{{list_id}}", "host": ["{{base_url}}"], "path": ["lists", "{{list_id}}"] }
          }
        }
      ]
    },

    {
      "name": "10. Tags",
      "item": [
        {
          "name": "Create tag",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/tags/", "host": ["{{base_url}}"], "path": ["tags", ""] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"user_id\": \"{{user_id}}\",\n  \"name\": \"purchased\",\n  \"color\": \"#1DBD8C\"\n}"
            }
          }
        },
        {
          "name": "Get all tags",
          "request": {
            "method": "GET",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/tags/?user_id={{user_id}}", "host": ["{{base_url}}"], "path": ["tags", ""], "query": [{ "key": "user_id", "value": "{{user_id}}" }] }
          }
        },
        {
          "name": "Tag contacts",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/tags/{{tag_id}}/contacts", "host": ["{{base_url}}"], "path": ["tags", "{{tag_id}}", "contacts"] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"contact_ids\": [\"{{contact_id}}\"]\n}"
            }
          }
        },
        {
          "name": "Untag contacts",
          "request": {
            "method": "DELETE",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/tags/{{tag_id}}/contacts", "host": ["{{base_url}}"], "path": ["tags", "{{tag_id}}", "contacts"] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"contact_ids\": [\"{{contact_id}}\"]\n}"
            }
          }
        },
        {
          "name": "Get tagged contacts",
          "request": {
            "method": "GET",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/tags/{{tag_id}}/contacts?page=1&limit=50", "host": ["{{base_url}}"], "path": ["tags", "{{tag_id}}", "contacts"], "query": [{ "key": "page", "value": "1" }, { "key": "limit", "value": "50" }] }
          }
        },
        {
          "name": "Delete tag",
          "request": {
            "method": "DELETE",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/tags/{{tag_id}}", "host": ["{{base_url}}"], "path": ["tags", "{{tag_id}}"] }
          }
        }
      ]
    },

    {
      "name": "11. Sequences",
      "item": [
        {
          "name": "Create sequence with steps",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/sequences/", "host": ["{{base_url}}"], "path": ["sequences", ""] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"user_id\": \"{{user_id}}\",\n  \"name\": \"New Student Onboarding\",\n  \"phone_number_id\": \"{{number_id}}\",\n  \"timezone\": \"Africa/Lagos\",\n  \"delivery_window_start\": \"09:00\",\n  \"delivery_window_end\": \"20:00\",\n  \"steps\": [\n    {\n      \"step_order\": 1,\n      \"step_type\": \"send_text\",\n      \"config\": {\n        \"body\": \"Hello {{first_name}}! Welcome to Funcare School. We are excited to have you.\"\n      }\n    },\n    {\n      \"step_order\": 2,\n      \"step_type\": \"wait\",\n      \"config\": { \"delay_value\": 1, \"delay_unit\": \"days\" }\n    },\n    {\n      \"step_order\": 3,\n      \"step_type\": \"send_text\",\n      \"config\": {\n        \"body\": \"Hi {{first_name}}, have you completed your registration form?\"\n      }\n    },\n    {\n      \"step_order\": 4,\n      \"step_type\": \"wait\",\n      \"config\": { \"delay_value\": 2, \"delay_unit\": \"days\" }\n    },\n    {\n      \"step_order\": 5,\n      \"step_type\": \"send_media\",\n      \"config\": {\n        \"url\": \"https://yourcdn.com/school-brochure.jpg\",\n        \"caption\": \"Here is our school brochure, {{first_name}}!\",\n        \"media_type\": \"image\"\n      }\n    }\n  ]\n}"
            }
          }
        },
        {
          "name": "List sequences",
          "request": {
            "method": "GET",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/sequences/?user_id={{user_id}}", "host": ["{{base_url}}"], "path": ["sequences", ""], "query": [{ "key": "user_id", "value": "{{user_id}}" }] }
          }
        },
        {
          "name": "Get sequence + steps",
          "request": {
            "method": "GET",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/sequences/{{sequence_id}}", "host": ["{{base_url}}"], "path": ["sequences", "{{sequence_id}}"] }
          }
        },
        {
          "name": "Pause sequence",
          "request": {
            "method": "PATCH",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/sequences/{{sequence_id}}", "host": ["{{base_url}}"], "path": ["sequences", "{{sequence_id}}"] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"status\": \"paused\"\n}"
            }
          }
        },
        {
          "name": "Replace all steps",
          "request": {
            "method": "PUT",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/sequences/{{sequence_id}}/steps", "host": ["{{base_url}}"], "path": ["sequences", "{{sequence_id}}", "steps"] },
            "body": {
              "mode": "raw",
              "raw": "[\n  {\n    \"step_order\": 1,\n    \"step_type\": \"send_text\",\n    \"config\": { \"body\": \"Welcome {{first_name}}!\" }\n  },\n  {\n    \"step_order\": 2,\n    \"step_type\": \"wait\",\n    \"config\": { \"delay_value\": 3, \"delay_unit\": \"hours\" }\n  }\n]"
            }
          }
        },
        {
          "name": "Delete sequence",
          "request": {
            "method": "DELETE",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/sequences/{{sequence_id}}", "host": ["{{base_url}}"], "path": ["sequences", "{{sequence_id}}"] }
          }
        }
      ]
    },

    {
      "name": "12. Enrollments",
      "item": [
        {
          "name": "Enroll contacts into sequence",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/automations/{{sequence_id}}/enroll", "host": ["{{base_url}}"], "path": ["automations", "{{sequence_id}}", "enroll"] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"contact_ids\": [\"{{contact_id}}\"],\n  \"phone_number_id\": \"{{number_id}}\"\n}"
            }
          }
        },
        {
          "name": "List active enrollments",
          "request": {
            "method": "GET",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/automations/{{sequence_id}}/enrollments?status=active&page=1", "host": ["{{base_url}}"], "path": ["automations", "{{sequence_id}}", "enrollments"], "query": [{ "key": "status", "value": "active" }, { "key": "page", "value": "1" }] }
          }
        },
        {
          "name": "Cancel enrollment",
          "request": {
            "method": "DELETE",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/automations/{{sequence_id}}/enrollments/{{enrollment_id}}", "host": ["{{base_url}}"], "path": ["automations", "{{sequence_id}}", "enrollments", "{{enrollment_id}}"] }
          }
        }
      ]
    },

    {
      "name": "13. Broadcasts",
      "item": [
        {
          "name": "Broadcast to list",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/broadcasts/", "host": ["{{base_url}}"], "path": ["broadcasts", ""] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"user_id\": \"{{user_id}}\",\n  \"phone_number_id\": \"{{number_id}}\",\n  \"message_type\": \"text\",\n  \"body\": \"Hello {{first_name}}, fees are due this Friday. Please ensure payment is made. — Funcare School\",\n  \"list_id\": \"{{list_id}}\"\n}"
            }
          }
        },
        {
          "name": "Broadcast to tag",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/broadcasts/", "host": ["{{base_url}}"], "path": ["broadcasts", ""] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"user_id\": \"{{user_id}}\",\n  \"phone_number_id\": \"{{number_id}}\",\n  \"message_type\": \"text\",\n  \"body\": \"Exclusive offer for {{first_name}} — VIP discount expires tonight!\",\n  \"tag_id\": \"{{tag_id}}\"\n}"
            }
          }
        },
        {
          "name": "Broadcast image to list",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/broadcasts/", "host": ["{{base_url}}"], "path": ["broadcasts", ""] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"user_id\": \"{{user_id}}\",\n  \"phone_number_id\": \"{{number_id}}\",\n  \"message_type\": \"image\",\n  \"media_url\": \"https://yourcdn.com/event-flyer.jpg\",\n  \"caption\": \"Our end of term event is here, {{first_name}}!\",\n  \"list_id\": \"{{list_id}}\"\n}"
            }
          }
        },
        {
          "name": "Get broadcast status",
          "request": {
            "method": "GET",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/broadcasts/{{batch_id}}", "host": ["{{base_url}}"], "path": ["broadcasts", "{{batch_id}}"] }
          }
        },
        {
          "name": "List all broadcasts",
          "request": {
            "method": "GET",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/broadcasts/?user_id={{user_id}}&page=1", "host": ["{{base_url}}"], "path": ["broadcasts", ""], "query": [{ "key": "user_id", "value": "{{user_id}}" }, { "key": "page", "value": "1" }] }
          }
        }
      ]
    },

    {
      "name": "14. Opt-outs",
      "item": [
        {
          "name": "List opted-out contacts",
          "request": {
            "method": "GET",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/opt-outs/?user_id={{user_id}}&page=1", "host": ["{{base_url}}"], "path": ["opt-outs", ""], "query": [{ "key": "user_id", "value": "{{user_id}}" }, { "key": "page", "value": "1" }] }
          }
        },
        {
          "name": "Manually opt out contact",
          "request": {
            "method": "POST",
            "header": [
              { "key": "Content-Type", "value": "application/json" },
              { "key": "x-api-key", "value": "{{api_key}}" }
            ],
            "url": { "raw": "{{base_url}}/opt-outs/", "host": ["{{base_url}}"], "path": ["opt-outs", ""] },
            "body": {
              "mode": "raw",
              "raw": "{\n  \"user_id\": \"{{user_id}}\",\n  \"phone_number\": \"2348012345678\"\n}"
            }
          }
        },
        {
          "name": "Re-enable opted-out contact",
          "request": {
            "method": "DELETE",
            "header": [{ "key": "x-api-key", "value": "{{api_key}}" }],
            "url": { "raw": "{{base_url}}/opt-outs/2348012345678?user_id={{user_id}}", "host": ["{{base_url}}"], "path": ["opt-outs", "2348012345678"], "query": [{ "key": "user_id", "value": "{{user_id}}" }] }
          }
        }
      ]
    },

    {
      "name": "15. Health Check",
      "item": [
        {
          "name": "API health",
          "request": {
            "method": "GET",
            "url": { "raw": "{{base_url}}/health", "host": ["{{base_url}}"], "path": ["health"] }
          }
        }
      ]
    }

  ]
}