{
  "info": {
    "name": "Connect Media SMS API",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "description": "Send SMS to Safaricom, Airtel and Telkom numbers in Kenya and 190+ countries through one HTTPS endpoint.\n\n**Setup:** create a free account at https://dashboard.connectmedia.co.ke/, generate an API key, and paste it into the collection variable `apiKey` (Current value only).\n\nAll requests are `POST {{baseUrl}}` with an `action`. Response codes: 201 sent, 200 balance, 202 history, 302 inbox; 100/401 authentication, 101 insufficient balance, 104 invalid recipients, 105 invalid message, 500 server error.\n\nDocs and code samples: https://connectmedia.co.ke/developers/ \u00b7 Pricing (from KES 1.0 per SMS, no minimum top-up): https://connectmedia.co.ke/pricing/ \u00b7 Support: info@connectmedia.co.ke"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://dashboard.connectmedia.co.ke/api.php"
    },
    {
      "key": "apiKey",
      "value": ""
    }
  ],
  "item": [
    {
      "name": "Send SMS",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"action\": \"send\",\n  \"to\": \"254712345678\",\n  \"sender\": \"YourBrand\",\n  \"message\": \"Hello from Connect Media\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "url": {
          "raw": "{{baseUrl}}",
          "host": [
            "{{baseUrl}}"
          ]
        },
        "description": "Send one message to one or more numbers. `to` is comma-separated, international format without + (2547XXXXXXXX). `sender` is your registered sender ID (max 11 characters). Add `\"schedule\": 1` and `\"schedule_datetime\": \"2026-12-01 09:00:00\"` to schedule. Success code: 201."
      }
    },
    {
      "name": "Check balance",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"action\": \"balance\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "url": {
          "raw": "{{baseUrl}}",
          "host": [
            "{{baseUrl}}"
          ]
        },
        "description": "Returns your current credit balance. Success code: 200."
      }
    },
    {
      "name": "Sent history",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"action\": \"history\",\n  \"limit\": 10,\n  \"offset\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "url": {
          "raw": "{{baseUrl}}",
          "host": [
            "{{baseUrl}}"
          ]
        },
        "description": "Lists sent messages with delivery status. Use `limit`, `offset`, `start_date` and `end_date` (YYYY-MM-DD). Success code: 202."
      }
    },
    {
      "name": "Inbox (replies)",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"action\": \"inbox\",\n  \"limit\": 10\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "url": {
          "raw": "{{baseUrl}}",
          "host": [
            "{{baseUrl}}"
          ]
        },
        "description": "Lists replies received from customers (two-way SMS). Success code: 302."
      }
    }
  ]
}