Skip to content
zonoDocs
On this page

Getting started

Build on Zono

Automate your helpdesk with the REST API and signed webhooks, connect apps with OAuth 2.0, bring AI clients in through the MCP server, and drive the live chat widget from your own code.

Quickstart

  1. Get a workspace

    Start free and create your workspace.

  2. Get a token

    Create an API key under Profile > API & MCP tokens, or let your app sign users in with OAuth 2.0.

  3. Make your first request

    Check which user, team and scopes your token has:

    GET /me
    curl https://zono.support/api/v1/me \
  -H "Authorization: Bearer $ZONO_TOKEN" \
  -H "Accept: application/json"

What you can build

REST APIRead and change tickets, customers, conversations, licenses and knowledge: 8 endpoint groups, an OpenAPI 3.1 document and a Postman collection. Read the docs API keys and OAuth appsUse an API key for your own scripts, or OAuth 2.0 with PKCE for apps that act on behalf of a user. Read the docs Signed webhooksHMAC-signed events when tickets, customers, conversations, ratings and SLAs change, retried for about 1.6 days. Read the docs MCP serverConnect Claude, ChatGPT, Cursor, VS Code or any Model Context Protocol client to your helpdesk, with scoped access. Read the docs Live chat widget JavaScript APIEmbed the chat with one snippet and open, close and listen to it from your own code. Read the docs Customer identityRecognise your signed-in users in the chat widget and sign them in to the customer portal, with one secret. Read the docs Issue tracker webhook setupPoint Linear and GitHub at Zono to sync issues: URLs, secrets and troubleshooting. Read the docs

Machine-readable docs

The same reference in formats tools and AI assistants read: an OpenAPI 3.1 document for the REST API, a short llms.txt summary of Zono, and llms-full.txt with every developer page in one plain-text file.

OpenAPI 3.1 spec llms.txt llms-full.txt