{
  "openapi": "3.0.3",
  "info": {
    "title": "Umney Connect Marketing API",
    "version": "1.0.0",
    "description": "Public Marketing API (marketing:send). Email campaign send requires Business Email entitlement and audience_json.emails[]. Docs: https://umneyconnect.com/developers/marketing"
  },
  "servers": [
    { "url": "https://umneyconnect.com/api", "description": "Production" },
    { "url": "https://www.staging.umneyconnect.com/api", "description": "Staging" }
  ],
  "tags": [{ "name": "Campaigns" }, { "name": "Templates" }],
  "components": {
    "securitySchemes": {
      "ApiKeyBearer": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "umk_live_marketing_…"
      },
      "ApiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    },
    "parameters": {
      "CampaignId": {
        "name": "id",
        "in": "path",
        "required": true,
        "schema": { "type": "string", "format": "uuid" }
      }
    }
  },
  "security": [{ "ApiKeyBearer": [] }, { "ApiKeyHeader": [] }],
  "paths": {
    "/v1/marketing/campaigns": {
      "get": {
        "tags": ["Campaigns"],
        "summary": "List campaigns",
        "operationId": "listMarketingCampaigns",
        "responses": { "200": { "description": "Campaign list" } }
      },
      "post": {
        "tags": ["Campaigns"],
        "summary": "Create campaign",
        "operationId": "createMarketingCampaign",
        "responses": { "200": { "description": "Campaign" } }
      }
    },
    "/v1/marketing/campaigns/{id}/send": {
      "post": {
        "tags": ["Campaigns"],
        "summary": "Send email campaign to audience_json.emails",
        "operationId": "sendMarketingCampaign",
        "parameters": [{ "$ref": "#/components/parameters/CampaignId" }],
        "responses": { "200": { "description": "Send results" } }
      }
    },
    "/v1/marketing/templates": {
      "get": {
        "tags": ["Templates"],
        "summary": "List templates",
        "operationId": "listMarketingTemplates",
        "responses": { "200": { "description": "Template list" } }
      },
      "post": {
        "tags": ["Templates"],
        "summary": "Create template",
        "operationId": "createMarketingTemplate",
        "responses": { "200": { "description": "Template" } }
      }
    }
  }
}