Getting started

The Cybooks Public API gives your own software access to a company's books in Cybooks: customers, vendors, invoices, bills, banking, the ledger, projects and more. Every operation is listed in the API Reference.

The base URL is https://api.cybooks.com.cy/v1.

Quick start

  1. In Cybooks, open the company the integration will access and go to Settings > API.
  2. Select Create API key, give it a name and choose only the permissions it needs. Copy the client ID and client secret.
  3. Request an access token with the scopes you need:
curl --request POST 'https://api.cybooks.com.cy/oauth/token' \
  --user "${CYBOOKS_CLIENT_ID}:${CYBOOKS_CLIENT_SECRET}" \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'grant_type=client_credentials' \
  --data-urlencode 'scope=customers:read'
  1. Call the API with the token:
curl 'https://api.cybooks.com.cy/v1/customers?per_page=25' \
  --header "Authorization: Bearer ${CYBOOKS_ACCESS_TOKEN}" \
  --header 'Accept: application/json'

Always send a scope when you request a token. A token without the scope an endpoint needs is refused with 403 Forbidden. The Authentication guide covers scopes, errors, rate limits, idempotent writes and key rotation.

Guides

  • Authentication: API keys, access tokens, errors and rate limits.
  • Webhooks: get notified when something changes, and verify the signature.
  • Event types: every event Cybooks sends.
  • Invoice numbering: when invoices, credit notes and vendor credits get their number.

Build with AI

  • Claude: the same operations power the Cybooks MCP server (in beta). Connect Claude from Integrations in Cybooks and ask about your numbers, or draft an invoice, in your own words.
  • Your own agent: llms.txt lists every page of these docs in Markdown and links the OpenAPI definition. Add .md to any page URL to get its Markdown.

Help

Include the X-Request-Id from the response when you contact Cybooks support.