# VertexCRM

> Multi-tenant CRM API (India). Org-scoped REST at /api/v1. Auth: Bearer vcr_… (Setup → API Keys). Lists paginate at 20 rows. Do not invent shop prices or undocumented endpoints.

Base: https://www.vertexcrm.in
API: https://www.vertexcrm.in/api/v1

## Docs (fetch these first)

- [Public API (markdown)](https://www.vertexcrm.in/developers.md): integrator contract
- [AI tools / MCP copy](https://www.vertexcrm.in/developers/ai.md): Cursor, Claude Code, Codex, ChatGPT
- [Paste-into-chat prompt](https://www.vertexcrm.in/developers/prompt.md): single system prompt
- [Agent skill](https://www.vertexcrm.in/developers/skill.md): short skill for coding agents
- [OpenAPI 3 JSON](https://www.vertexcrm.in/openapi.json): machine spec
- [Full dump](https://www.vertexcrm.in/llms-full.txt): concatenated docs
- [Swagger / Redoc](https://www.vertexcrm.in/docs): human explorer
- [MCP (docs, HTTP)](https://www.vertexcrm.in/mcp): Model Context Protocol, public docs only

## API objects (v1 only)

Accounts, contacts, leads, opportunities, cases. Inbox, gallery, products, campaigns, users are not on v1.

Lead status: Open - Not Contacted | Working - Contacted | Closed - Converted | Closed - Not Converted
Lead rating: Hot | Warm | Cold
Opportunity stage: Prospecting | Qualification | Needs Analysis | Value Proposition | Negotiation | Closed Won | Closed Lost
Case status: New | Working | Escalated | Closed | On Hold
Case priority: High | Medium | Low

## Partner webhooks (not vcr_ keys)

POST /webhooks/inbound-leads — X-Inbound-Secret or Bearer INBOUND_LEAD_SECRET; optional X-Org-Slug
POST /api/booking-forms/whatsapp — Bearer BOOKING_FORMS_WHATSAPP_TOKEN; body {to, message, name, template}

## Rules for agents

1. Read /developers.md before writing client code.
2. Prefer API keys over scraping HTML.
3. per_page is fixed at 20; walk page=.
4. PUT is read-modify-write. DELETE returns {ok:true} with HTTP 200.
5. Never log or embed vcr_ keys in browser JS.
6. Do not claim Inbox or WhatsApp send on /api/v1.