# ConnectCloud API > Public REST APIs of ConnectCloud, MBCOM's multi-tenant business platform, one per module: HR (employees, absences, working time; issues access tokens), Desk (tickets, issues, tasks), Comms (mail and webhook channels, delivery log), Trade (offers, orders, invoices), DMS (documents), master data (addresses, articles), CRM, workflow (approvals), flows (automation) and search. Authenticate by exchanging an API key at POST /api/hr/v1/auth/token for a 15-minute bearer token. Every page is available as Markdown (append `.md`). MCP server (read-only, no login): https://developers.mbcom.cloud/mcp. Sandbox with example answers: https://developers.mbcom.cloud/sandbox/. ## Guides - [Introduction](https://developers.mbcom.cloud/guides/introduction.md): What the ConnectCloud API offers, how it is organised and where to start. - [Quickstart](https://developers.mbcom.cloud/guides/quickstart.md): Create an API key, exchange it for an access token and make your first call. - [Authentication](https://developers.mbcom.cloud/guides/authentication.md): API keys, service accounts, short-lived access tokens, permissions and tenants. - [Environments and base URLs](https://developers.mbcom.cloud/guides/environments.md): Production, staging and sandbox origins, base paths and transport requirements. - [Errors](https://developers.mbcom.cloud/guides/errors.md): The error shape, HTTP status codes, error codes and what to retry. - [Pagination and delta sync](https://developers.mbcom.cloud/guides/pagination.md): Cursor and offset pagination, limits, sorting and syncing changes with updatedSince. - [Idempotency and concurrency](https://developers.mbcom.cloud/guides/idempotency-and-concurrency.md): Safe retries with Idempotency-Key and dedupeKey, and optimistic locking with version. - [Rate limits](https://developers.mbcom.cloud/guides/rate-limits.md): Request limits per principal and route, the 429 answer and how to stay below them. - [Webhooks](https://developers.mbcom.cloud/guides/webhooks.md): Receive signed events when tickets, absences or documents change, verify signatures, and send events into ConnectCloud. - [Versioning and changes](https://developers.mbcom.cloud/guides/versioning.md): How the API is versioned, what counts as a breaking change and how deprecations are announced. - [Sandbox](https://developers.mbcom.cloud/guides/sandbox.md): Try every endpoint against example answers without an account, from the browser, curl or an AI agent. - [AI agents](https://developers.mbcom.cloud/guides/ai-agents.md): Let coding assistants and AI agents read this documentation through MCP, llms.txt, Markdown pages and an agent skill. - [Careers API](https://developers.mbcom.cloud/guides/careers.md): Show a tenant's open positions on your own website and take applications without a token. - [Projects, plans and billing](https://developers.mbcom.cloud/guides/projects.md): Create desk projects from templates, plan milestones and dependencies, react to delays, bill payment plans through trade and read the hours booked in HR. - [Handoff and conversion](https://developers.mbcom.cloud/guides/handoffs.md): Hand desk tickets and forge items over to each other (Übergabe), hand them back (Zurückgeben) and convert them (Umwandeln), with idempotency, delivery states and events. - [Flows](https://developers.mbcom.cloud/guides/flows.md): Build automations as YAML – validate, test (dry by default), publish, start by hand or by webhook, send mail, follow runs and answer tasks; templates with parameters, flows of a desk space or forge project and the immediate automations of desk and forge. - [Work entries (HR)](https://developers.mbcom.cloud/guides/work-entries.md): Book work (Leistungen) in HR as a length, with start and end or with a stopwatch, attach it to a subject, approve it and bill approved work to trade in batches. - [Documents (DMS)](https://developers.mbcom.cloud/guides/dms.md): Upload documents to the DMS, file them in folders, wait for the malware scan, add versions, link them to records and download them. - [Sales documents and e-invoices (Trade)](https://developers.mbcom.cloud/guides/trade.md): Create offers and orders, deliver and invoice them, issue XRechnung e-invoices, process inbound e-invoices and handle the workflow lock (423 workflow_locked). - [Desk tickets](https://developers.mbcom.cloud/guides/desk-tickets.md): Read the tenant's desk configuration from the bootstrap endpoint, create tickets, move them through their workflow, reply by comment or mail and add attachments. - [Addresses and articles (master data)](https://developers.mbcom.cloud/guides/masterdata.md): Read and write customer and supplier addresses and articles, and keep an external system such as a CRM, shop or ERP in sync with paging and change detection. - [Leads and opportunities (CRM)](https://developers.mbcom.cloud/guides/crm.md): Capture leads with duplicate checks, convert them into master data customers with a first opportunity, and move opportunities through the tenant's pipeline to won or lost. - [Forge items](https://developers.mbcom.cloud/guides/forge-items.md): Read a forge project's configuration, create items such as APP-12, search them across projects and move them through the project's workflow by status or status category. - [Mail, channels and the delivery log (Comms)](https://developers.mbcom.cloud/guides/comms.md): What the comms module offers API clients – mail and webhook channels, the delivery log with retries, receiving mailboxes and the Belegeingang address – and how mail is sent from a client's point of view. ## API reference - [HR API](https://developers.mbcom.cloud/reference/hr.md): Employees, roles and groups, absences and vacation accounts, working time, travel expenses and the organisation chart. Also issues the access tokens for every other API. (173 operations, all of them in one Markdown file) - [Desk API](https://developers.mbcom.cloud/reference/desk.md): Tickets, issues and tasks with configurable spaces, types, workflows and fields; comments, mail, attachments, SLAs, automation rules, projects and their payment plans. (166 operations, all of them in one Markdown file) - [Forge API](https://developers.mbcom.cloud/reference/forge.md): Software development: projects with linked repositories, items (APP-12) with sections, links, milestones, iterations and the backlog, views, automations, and the handoff and conversion of items to and from desk. (132 operations, all of them in one Markdown file) - [Comms API](https://developers.mbcom.cloud/reference/comms.md): Outgoing mail and webhooks: channels, templates, the delivery log, inbound webhooks and mailboxes. (35 operations, all of them in one Markdown file) - [DMS API](https://developers.mbcom.cloud/reference/dms.md): Documents with versions, links to records, text extraction, containers, compliance (audit, legal hold) and exports. (58 operations, all of them in one Markdown file) - [Trade API](https://developers.mbcom.cloud/reference/trade.md): Offers, orders, invoices and credit notes, contracts, purchase orders and goods receipts, inbound invoices with their checks, MSP and ITSP (distributor catalog) and the trade settings. (169 operations, all of them in one Markdown file) - [Master data API](https://developers.mbcom.cloud/reference/masterdata.md): Addresses (customers, suppliers) with contacts and postal addresses, articles, product groups, lookup tables, number ranges and the tenant profile. (60 operations, all of them in one Markdown file) - [CRM API](https://developers.mbcom.cloud/reference/crm.md): Leads, campaigns, opportunities and customer satisfaction (CSAT), the customer timeline of calls and meetings, address quality checks and the NFON phone book settings. (48 operations, all of them in one Markdown file) - [Workflow API](https://developers.mbcom.cloud/reference/workflow.md): Approval workflows: blueprints, the tasks of a person, running instances and the tenant's workflow configuration. (33 operations, all of them in one Markdown file) - [Flows API](https://developers.mbcom.cloud/reference/flows.md): Automation: flows as YAML graphs of triggers (events, schedules, manual starts, webhooks) and nodes (module actions, conditions, human tasks, waits, loops, sub-flows, mail, AI); drafts, validation, test runs, publishing, runs with their node history and the task inbox. (31 operations, all of them in one Markdown file) - [Search API](https://developers.mbcom.cloud/reference/search.md): Full-text search over the tenant's desk, CRM, master data, trade, knowledge, HR and comms records and its DMS documents. (2 operations, all of them in one Markdown file) - [Status API](https://developers.mbcom.cloud/reference/status.md): Whether the modules of the environment are working: one public request, no token. (1 operations, all of them in one Markdown file) ## OpenAPI - [HR OpenAPI 3.1 document](https://developers.mbcom.cloud/openapi/hr.yaml) - [Desk OpenAPI 3.1 document](https://developers.mbcom.cloud/openapi/desk.yaml) - [Forge OpenAPI 3.1 document](https://developers.mbcom.cloud/openapi/forge.yaml) - [Comms OpenAPI 3.1 document](https://developers.mbcom.cloud/openapi/comms.yaml) - [DMS OpenAPI 3.1 document](https://developers.mbcom.cloud/openapi/dms.yaml) - [Trade OpenAPI 3.1 document](https://developers.mbcom.cloud/openapi/trade.yaml) - [Master data OpenAPI 3.1 document](https://developers.mbcom.cloud/openapi/masterdata.yaml) - [CRM OpenAPI 3.1 document](https://developers.mbcom.cloud/openapi/crm.yaml) - [Workflow OpenAPI 3.1 document](https://developers.mbcom.cloud/openapi/workflow.yaml) - [Flows OpenAPI 3.1 document](https://developers.mbcom.cloud/openapi/flows.yaml) - [Search OpenAPI 3.1 document](https://developers.mbcom.cloud/openapi/search.yaml) - [Status OpenAPI 3.1 document](https://developers.mbcom.cloud/openapi/status.yaml) ## Optional - [Everything in one file](https://developers.mbcom.cloud/llms-full.txt): all guides and all operations - [Agent skill](https://developers.mbcom.cloud/agents/skill/SKILL.md): a SKILL.md for Claude and other agents - [Operations of the HR API, one page each](https://developers.mbcom.cloud/reference/hr): e.g. https://developers.mbcom.cloud/reference/hr/getBootstrap.md - [Operations of the Desk API, one page each](https://developers.mbcom.cloud/reference/desk): e.g. https://developers.mbcom.cloud/reference/desk/getBootstrap.md - [Operations of the Forge API, one page each](https://developers.mbcom.cloud/reference/forge): e.g. https://developers.mbcom.cloud/reference/forge/getForgeStatus.md - [Operations of the Comms API, one page each](https://developers.mbcom.cloud/reference/comms): e.g. https://developers.mbcom.cloud/reference/comms/getBootstrap.md - [Operations of the DMS API, one page each](https://developers.mbcom.cloud/reference/dms): e.g. https://developers.mbcom.cloud/reference/dms/listDocuments.md - [Operations of the Trade API, one page each](https://developers.mbcom.cloud/reference/trade): e.g. https://developers.mbcom.cloud/reference/trade/listTransactions.md - [Operations of the Master data API, one page each](https://developers.mbcom.cloud/reference/masterdata): e.g. https://developers.mbcom.cloud/reference/masterdata/listAddresses.md - [Operations of the CRM API, one page each](https://developers.mbcom.cloud/reference/crm): e.g. https://developers.mbcom.cloud/reference/crm/listLeads.md - [Operations of the Workflow API, one page each](https://developers.mbcom.cloud/reference/workflow): e.g. https://developers.mbcom.cloud/reference/workflow/getWorkflowConfig.md - [Operations of the Flows API, one page each](https://developers.mbcom.cloud/reference/flows): e.g. https://developers.mbcom.cloud/reference/flows/getFlowsCatalog.md - [Operations of the Search API, one page each](https://developers.mbcom.cloud/reference/search): e.g. https://developers.mbcom.cloud/reference/search/searchRecords.md - [Operations of the Status API, one page each](https://developers.mbcom.cloud/reference/status): e.g. https://developers.mbcom.cloud/reference/status/getModuleStatus.md