{
  "info": {
    "_postman_id": "mailgx-api-v1",
    "name": "MailGX Disposable Email API",
    "description": "REST API collection for MailGX temp mail — create mailboxes, poll messages, test OTP flows, and send replies.\n\nSetup:\n1. Import this collection into Postman\n2. Set `baseUrl` to your MailGX site (e.g. https://mailgx.org)\n3. Set `apiKey` to your dashboard API key (Bearer rm_live_...)\n\nDocs: {{baseUrl}}/api-docs",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    { "key": "baseUrl", "value": "https://mailgx.org" },
    { "key": "apiKey", "value": "rm_live_your_key_here" },
    { "key": "mailbox", "value": "test@mailgx.org" },
    { "key": "messageId", "value": "msg-uuid-1" }
  ],
  "auth": {
    "type": "bearer",
    "bearer": [{ "key": "token", "value": "{{apiKey}}", "type": "string" }]
  },
  "item": [
    {
      "name": "Mailboxes",
      "item": [
        {
          "name": "Create mailbox (auto-generate)",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"autoGenerate\": true,\n  \"domain\": \"mailgx.org\"\n}"
            },
            "url": "{{baseUrl}}/api/v1/mailboxes"
          }
        },
        {
          "name": "Create mailbox (custom local part)",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"localPart\": \"qa-signup\",\n  \"domain\": \"mailgx.org\",\n  \"autoGenerate\": false\n}"
            },
            "url": "{{baseUrl}}/api/v1/mailboxes"
          }
        },
        {
          "name": "List mailboxes",
          "request": {
            "method": "GET",
            "url": "{{baseUrl}}/api/v1/mailboxes"
          }
        },
        {
          "name": "Get mailbox with messages",
          "request": {
            "method": "GET",
            "url": {
              "raw": "{{baseUrl}}/api/v1/mailboxes/{{mailbox}}?limit=50",
              "host": ["{{baseUrl}}"],
              "path": ["api", "v1", "mailboxes", "{{mailbox}}"],
              "query": [{ "key": "limit", "value": "50" }]
            }
          }
        },
        {
          "name": "Delete mailbox",
          "request": {
            "method": "DELETE",
            "url": "{{baseUrl}}/api/v1/mailboxes/{{mailbox}}"
          }
        }
      ]
    },
    {
      "name": "Messages",
      "item": [
        {
          "name": "List messages in mailbox",
          "request": {
            "method": "GET",
            "url": {
              "raw": "{{baseUrl}}/api/v1/messages?mailbox={{mailbox}}&limit=20",
              "host": ["{{baseUrl}}"],
              "path": ["api", "v1", "messages"],
              "query": [
                { "key": "mailbox", "value": "{{mailbox}}" },
                { "key": "limit", "value": "20" }
              ]
            }
          }
        },
        {
          "name": "Get single message",
          "request": {
            "method": "GET",
            "url": {
              "raw": "{{baseUrl}}/api/v1/messages/{{messageId}}?mailbox={{mailbox}}",
              "host": ["{{baseUrl}}"],
              "path": ["api", "v1", "messages", "{{messageId}}"],
              "query": [{ "key": "mailbox", "value": "{{mailbox}}" }]
            }
          }
        }
      ]
    },
    {
      "name": "Reply",
      "item": [
        {
          "name": "Send reply to latest incoming message",
          "request": {
            "method": "POST",
            "header": [{ "key": "Content-Type", "value": "application/json" }],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"mailbox\": \"{{mailbox}}\",\n  \"body\": \"Thank you — we received your message.\"\n}"
            },
            "url": "{{baseUrl}}/api/v1/reply"
          }
        }
      ]
    }
  ]
}
