# NextX Developers

> Public REST API, webhooks and MCP server for NextX. REST base URL: https://api.nextx.vn. MCP server (OAuth): https://mcp.nextx.vn/mcp. Auth: OAuth 2.0 (client credentials / authorization code) or API key. Tooling: Node.js/Python SDK, `nextx` CLI.

## Docs
- [Quickstart](https://developers.nextx.vn/en/docs/quickstart): register an app, get a token, make the first call
- [API overview](https://developers.nextx.vn/en/docs): base URL, calling the API, endpoints by module
- [Apps & OAuth](https://developers.nextx.vn/en/docs/oauth): OAuth app vs API key, client credentials token, scopes
- [Error codes](https://developers.nextx.vn/en/docs/errors): problem+json body, HTTP codes, retries
- [Rate limit](https://developers.nextx.vn/en/docs/rate-limit): 600/min per app, key or MCP connection; workspace bucket by plan; 429 + Retry-After
- [Sandbox](https://developers.nextx.vn/en/docs/sandbox): production vs sandbox base URLs
- [Data model](https://developers.nextx.vn/en/docs/data-model): core objects and their API paths
- [Guide: webhook-don-hang-erp](https://developers.nextx.vn/en/docs/guides/webhook-don-hang-erp)
- [Guide: cong-cu-ai-rest](https://developers.nextx.vn/en/docs/guides/cong-cu-ai-rest)
- [Guide: n8n-make](https://developers.nextx.vn/en/docs/guides/n8n-make)
- [crm API](https://developers.nextx.vn/en/docs/crm): 9 endpoints — Contacts, opportunities/deals, activities — core customer data.
- [comm API](https://developers.nextx.vn/en/docs/comm): 1 endpoints — Send messages to conversation channels (Zalo OA, …).
- [sales API](https://developers.nextx.vn/en/docs/sales): 6 endpoints — Orders, products, stock, customers (POS/sales).
- [office API](https://developers.nextx.vn/en/docs/office): 10 endpoints — No-code data tables (Base/Bitable) and approval flows (Approval).
- [hrm API](https://developers.nextx.vn/en/docs/hrm): 5 endpoints — Attendance devices, punches and staff time history.
- [dms API](https://developers.nextx.vn/en/docs/dms): 7 endpoints — Catalog, visits (check-in), daily plans, outlets, orders and routes.
- [call API](https://developers.nextx.vn/en/docs/call): 7 endpoints — Call center agents, campaigns, call/IVR flows, phone numbers, calls and queues.
- [marketing API](https://developers.nextx.vn/en/docs/marketing): 6 endpoints — Email campaigns, email templates, Google integrations, reports and sender profiles.
- [payment API](https://developers.nextx.vn/en/docs/payment): 6 endpoints — Read-only — payment intents, refunds, transactions, subscriptions and payment reports.
- [einvoice API](https://developers.nextx.vn/en/docs/einvoice): 5 endpoints — Read-only — e-invoices, series, summary reports and settings.
- [Webhooks](https://developers.nextx.vn/en/docs/webhooks): 33 events, signatures, retries
- [MCP](https://developers.nextx.vn/en/docs/mcp): connect an AI assistant over OAuth
- [AI tools](https://developers.nextx.vn/en/docs/ai-tools): 230 tools available to AI assistants; read tools are also callable over REST with an API key: POST https://api.nextx.vn/api/v1/ai/tools/{module}/{name}/read (header X-Api-Key)
- [Security](https://developers.nextx.vn/en/docs/security)
- [SDK](https://developers.nextx.vn/en/docs/sdk): typed Node.js/TypeScript and Python clients generated from the OpenAPI document · `npm install @nextxai/sdk` · `pip install nextx-sdk`
- [CLI](https://developers.nextx.vn/en/docs/cli): `nextx` v0.3.5 — sign in, ask the AI assistant, call the API, listen to webhooks locally, run in CI · `brew install nextx-organization/nextx/nextx` · `npm install -g @nextxai/cli`
- [Versioning & deprecation](https://developers.nextx.vn/en/docs/versioning)
- [Changelog](https://developers.nextx.vn/en/docs/changelog)

## Machine-readable
- [OpenAPI 3](https://developers.nextx.vn/openapi.json)
- [Postman collection](https://developers.nextx.vn/postman_collection.json)
- [Full docs for LLMs](https://developers.nextx.vn/llms-full.txt)