Docs & API reference
Understand, operate and integrate Vazmo properly.
Vazmo is a paperwork action platform. It helps users understand letters, notices, forms and messages, then turn them into clear next steps, saved results, reminders and ready-to-edit drafts. Developers can also connect approved systems through the Smart Fix API.
Support
Need help with Vazmo?
Use this page as the official Vazmo support URL. For account or product questions, email support@vazmo.com.
If you have an account, sign in and ask Vazmo AI. Vazmo can guide you through Smart Fix, billing, free tools, documentation and common portal questions.
Product overview
What Vazmo does
Vazmo helps users turn confusing paperwork into clear next steps. It is designed for everyday UK paperwork and life tasks, not open-ended conversation only.
Quick Explain turns a letter, notice or form into plain English with the key issue, amount, deadline and risk.
Full Action Pack creates next steps, evidence lists, draft email or letter text, copy-paste replies and reminders.
Every Smart Fix result is saved as a case so users can return to the result, edit templates and track follow-ups.
Smart Fix workflow
Creating a Smart Fix case
The Smart Fix flow is for proper document analysis. Users can attach a file, choose a category, describe the issue and pick the output depth.
General Document Help can be used when the user is unsure. Specific categories include PCN, council, debt, rent, court, HMRC, bank, contract, employment, motoring, immigration paperwork, property, scam and business growth.
Users can upload common documents and images or paste a message. A case should include enough context for the AI to identify deadlines, risk and next steps.
Quick Explain is a lower-cost explanation. Full Action Pack is for next steps, drafts, evidence checklist, reminders and downloadable outputs.
The result is stored in case history. Users can copy, edit or download templates and leave feedback on whether the result helped.
Best for understanding what a document means before taking action. The current price is shown before the user creates the result.
Best when the user needs practical next actions, draft replies, evidence lists and a saved workflow. The current price is shown before the user creates the result.
Case result page
What a saved result includes
The case detail page is the main workspace for a document issue. It keeps the AI result, editable drafts and reminders together.
| Summary | Plain English explanation, document type, risk, urgency, amount and deadline if detected. |
| Recommended next steps | Practical checklist users can follow after reading the document. |
| Evidence checklist | Documents, screenshots, references or receipts the user should keep before replying. |
| Templates | Email subject/body, letter body and short copy-paste reply where available. |
| Reminders | Email reminders are free. SMS reminders can be charged depending on settings. |
| Feedback | Users can rate results 1–5 and explain whether the result helped. Eligible case feedback can also count towards feedback rewards where available. |
Ask Vazmo AI
Quick chat for guidance
Ask Vazmo is for quick questions, small messages and early guidance. It can also help users decide whether to create a proper Smart Fix result.
Users can ask everyday paperwork questions and receive clear British English answers.
Users can attach a file in chat. If deeper analysis is needed, Vazmo can guide them to Quick Explain or Full Action Pack.
Chat history opens in an off-canvas panel with pagination so older conversations stay available without cluttering the page.
Users can like or dislike chat messages so the chat experience can be improved. Chat likes do not award free credits.
User portal dashboard
Dashboard structure
The dashboard gives users a quick operational view of their plan, credits, actions, reminders, cases and usage.
Balance, included cases, total cases and open tickets stay visible at the top.
Full-width action cards help users start Smart Fix, open Ask Vazmo, manage billing, visit free tools or contact support.
A full-width reminders section highlights upcoming document follow-ups.
Daily, weekly and monthly chart filters show Smart Fix case usage and Ask Vazmo chat usage.
Free tools
Tools users can open without creating a full case
Free tools are lightweight helpers for common calculations, wording and paperwork checks. In the portal menu they sit near Developer as a normal icon item, not hidden inside a submenu.
Quick estimates and simple paperwork calculations where a full Smart Fix is unnecessary.
Help with short wording, replies and simple explanations.
When a tool result needs deeper analysis, users can move into Quick Explain or Full Action Pack.
Credits and plans
How usage is charged
Vazmo uses included cases first, then account balance. The user sees the available allowance, balance and case price before starting a paid result.
| Included cases | Used before paid balance. Shown in the user dashboard and Ask Vazmo personal plan box. |
| Balance | Used when included cases are finished. Users can top up and manage billing from the portal. |
| Quick Explain | Lower-cost document explanation mode. |
| Full Action Pack | Full saved action result with templates and next steps. |
| Feedback reward | Case/result feedback can award 1 free credit after every 5 eligible feedback submissions if enabled in the codebase. |
Support
Official support URL
This documentation page is the official support page for Vazmo. It explains the product and gives users clear ways to get help.
For help with your account, billing, Smart Fix results or technical questions, contact support@vazmo.com.
Signed-in users can ask Vazmo AI about how to use the platform. If the question cannot be resolved, Vazmo can help create a support ticket.
Privacy & safety
How Vazmo helps users stay safe
Users should upload only documents they are allowed to process and should always check names, dates, amounts and draft wording before relying on a result.
- ✓Login, registration and sensitive actions may use extra protection such as Cloudflare Turnstile.
- ✓API secret keys must stay server-side and should never be placed in browser JavaScript.
- ✓Vazmo results are guidance and draft support only; urgent, legal, medical or regulated matters should be checked with the right professional.
- ✓Documents and case results stay available in saved case history so users can return to them when needed.
API overview
Smart Fix API
The API lets approved accounts submit a document or description and receive the same structured Smart Fix output that users receive in the portal.
POST https://vazmo.com/api/v1/smart-fix
multipart/form-data for document upload and text fields.
Uses included cases first, then balance. Insufficient funds returns 402.
Authentication
API keys
Each request must include the public key and secret key. Keys can be viewed, paused or rotated from the Developer portal.
X-Vazmo-Public-Key: vazmo_pk_live_...
X-Vazmo-Secret-Key: vazmo_sk_live_...Request
POST https://vazmo.com/api/v1/smart-fix
Upload a file, provide text, or send both. At least one document or description is required.
| document | Optional file: PDF, DOCX, JPG, PNG, WEBP, TXT, CSV, XLSX. |
| analysis_mode | explain for Quick Explain or action for Full Action Pack. |
| category_slug | general, pcn, council, debt, rent, court, hmrc, tax-planning, bank, flight, contract, business, insurance, medical-admin, employment, motoring, immigration-admin, property, scam, growth. |
| issue_type | Short label such as Parking Charge Notice, HMRC letter, tenancy dispute or supplier contract. |
| description | Optional user notes. Required when no document is uploaded. |
| output_language | en-GB, tr, zh-CN, zh-HK, ur, ar, pl, ro, es, fr, de, nl, it, pt, uk, ru, hi, bn, pa. |
Workflow APIs
Use Vazmo beyond Smart Fix
Approved accounts can use plan-limited endpoints for Ask Vazmo chat, Command Centre data, Inbox items, saved cases and action items. Every endpoint uses API keys, active-account checks, SMS verification, hourly rate limits and plan feature gates.
POST /api/v1/ask-vazmo
Send a quick product, paperwork or workflow question. Uses the plan's Ask Vazmo daily allowance.
GET /api/v1/command-centre
Load cases, inbox items and action items for a date range. Max range is 62 days.
GET/POST /api/v1/inbox-items
Create inbox items from apps, stores, WhatsApp providers or email pipes. Personal+ for basic inbox; Business+ for email/commerce sources.
GET /api/v1/cases
List saved Smart Fix cases for the authenticated account.
POST /api/v1/action-items
Create reminders and team workflow tasks. Personal+ for own reminders; Business+ for shared team workflows.
POST /api/v1/smart-fix
Create Quick Explain or Full Action Pack results from documents and notes.
Plugins & channels
WordPress, stores, browser extension, WhatsApp and email
Vazmo provides starter downloads from Account > Plugins. These are designed as safe server-side starters, not final bespoke integrations for every store.
Select text on a website and send it into Vazmo Inbox or Ask Vazmo. For security, secret keys should be proxied through your server.
WordPress, PrestaShop and OpenCart starter packages can create inbox items for customer messages, order disputes and supplier admin.
Create a catch-all or forwarder for inbox.vazmo.com, then pipe messages to a small server script that calls /api/v1/inbox-items. This avoids relying on Plesk mailboxes for final delivery to Hotmail/Outlook.
Use a WhatsApp Business provider webhook to post the sender, message and source into the Inbox API. Business and Custom plans should use this for team workflows.
Examples
cURL and JavaScript
Use these examples as a starting point for server-side integrations.
curl -X POST "https://vazmo.com/api/v1/smart-fix" \
-H "X-Vazmo-Public-Key: vazmo_pk_live_xxx" \
-H "X-Vazmo-Secret-Key: vazmo_sk_live_xxx" \
-F "analysis_mode=action" \
-F "category_slug=pcn" \
-F "issue_type=Parking Charge Notice" \
-F "output_language=en-GB" \
-F "document=@notice.pdf"const form = new FormData();
form.append('analysis_mode', 'explain');
form.append('category_slug', 'general');
form.append('description', 'Explain this council letter in plain English.');
const response = await fetch('https://vazmo.com/api/v1/smart-fix', {
method: 'POST',
headers: {
'X-Vazmo-Public-Key': process.env.VAZMO_PUBLIC_KEY,
'X-Vazmo-Secret-Key': process.env.VAZMO_SECRET_KEY
},
body: form
});
const data = await response.json();Response
Successful response
The API returns the saved case URL plus structured fields that can be shown in your own application.
{
"success": true,
"case": {
"id": 123,
"token": "a1b2c3d4e5f6",
"url": "https://vazmo.com/cases/a1b2c3d4e5f6",
"mode": "action",
"title": "Parking Charge Notice",
"summary": "...",
"risk_level": "medium",
"urgency": "medium",
"deadline_at": "2026-06-30",
"amount_text": "£100",
"next_steps": [],
"evidence_checklist": [],
"draft_email_subject": "...",
"draft_email_body": "...",
"draft_letter_body": "...",
"copy_paste_reply": "..."
},
"billing": {
"charged_pence": 25,
"balance_pence": 500,
"included_cases_remaining": 2
}
}Limits and protection
Access rules
API requests are checked before analysis runs.
- ✓API keys must exist and be active.
- ✓The user account must be active.
- ✓Hourly limits depend on the account plan.
- ✓Included cases are consumed before balance.
- ✓If no included cases or balance are available, the request returns
402.
Errors
Common error responses
Handle these responses in your integration and show a user-friendly message.
Missing or invalid API keys.
missing_api_keysAPI key paused or account inactive.
api_key_not_activeNo included cases or balance available.
insufficient_creditMissing document and description.
missing_inputHourly plan limit reached.
rate_limit_exceededServer or AI processing error.
server_error