{"openapi":"3.0.3","info":{"title":"FlowMaticX API","version":"2.0.0","description":"Public REST API for FlowMaticX — lead gen, campaigns, CRM, automations, SEO audits, and AI copilot.","contact":{"email":"api@flowmaticx.com"}},"servers":[{"url":"https://flowmaticx.com","description":"Production"}],"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"x-api-key","description":"Workspace API key from /workspace/api-keys"}},"schemas":{"Lead":{"type":"object","properties":{"id":{"type":"integer"},"businessName":{"type":"string"},"email":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"category":{"type":"string","nullable":true},"pipelineStage":{"type":"string","enum":["NEW","CONTACTED","REPLIED","MEETING","WON","LOST"]},"createdAt":{"type":"string","format":"date-time"}}},"Campaign":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"status":{"type":"string","enum":["DRAFT","RUNNING","PAUSED","COMPLETED"]},"sentCount":{"type":"integer"},"replyCount":{"type":"integer"},"wonCount":{"type":"integer"}}},"Sequence":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"steps":{"type":"array","items":{"type":"object"}},"active":{"type":"boolean"}}}}},"paths":{"/api/leads/export":{"get":{"summary":"Export leads as CSV","tags":["Leads"],"responses":{"200":{"description":"CSV file"}}}},"/api/outreach/mailboxes":{"get":{"summary":"List connected mailboxes","tags":["Mailboxes"],"responses":{"200":{"description":"Array of mailbox objects"}}},"post":{"summary":"Connect a new SMTP/IMAP mailbox","tags":["Mailboxes"],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"Created mailbox"}}}},"/api/outreach/sequences":{"get":{"summary":"List sequences","tags":["Sequences"],"responses":{"200":{"description":"Array"}}},"post":{"summary":"Create a sequence","tags":["Sequences"],"responses":{"200":{"description":"Created"}}}},"/api/campaigns":{"get":{"summary":"List campaigns","tags":["Campaigns"],"responses":{"200":{"description":"Array"}}},"post":{"summary":"Create a campaign","tags":["Campaigns"],"responses":{"200":{"description":"Created"}}}},"/api/campaigns/{id}/launch":{"post":{"summary":"Launch / pause / resume a campaign","tags":["Campaigns"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"action","in":"query","schema":{"type":"string","enum":["launch","pause","resume"]}}],"responses":{"200":{"description":"Status update"}}}},"/api/brain":{"get":{"summary":"Get workspace Brain","tags":["Brain"],"responses":{"200":{"description":"Brain object"}}},"put":{"summary":"Update workspace Brain","tags":["Brain"],"responses":{"200":{"description":"Updated"}}}},"/api/copilot/chat":{"post":{"summary":"Send a copilot chat message","tags":["Copilot"],"responses":{"200":{"description":"Reply + suggestions"}}}},"/api/automations":{"get":{"summary":"List automations","tags":["Automations"],"responses":{"200":{"description":"Array"}}},"post":{"summary":"Create an automation","tags":["Automations"],"responses":{"200":{"description":"Created"}}}},"/api/jobs":{"post":{"summary":"Start a lead generation job","tags":["Jobs"],"responses":{"200":{"description":"Job created"}}}},"/api/webhooks/wasender":{"post":{"summary":"Incoming WhatsApp webhook from Wasender","tags":["WhatsApp"],"responses":{"200":{"description":"OK"}}}}},"tags":[{"name":"Leads","description":"CRM lead management"},{"name":"Campaigns","description":"Outreach campaigns"},{"name":"Sequences","description":"Email sequence templates"},{"name":"Mailboxes","description":"Connected email accounts"},{"name":"Brain","description":"Workspace AI memory"},{"name":"Copilot","description":"AI Copilot chat"},{"name":"Automations","description":"Visual workflow automations"},{"name":"Jobs","description":"Lead generation jobs"},{"name":"WhatsApp","description":"Wasender WhatsApp integration"}]}