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
- In Cybooks, open the company the integration will access and go to Settings > API.
- Select Create API key, give it a name and choose only the permissions it needs. Copy the client ID and client secret.
- 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'- 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
.mdto any page URL to get its Markdown.
Help
Include the X-Request-Id from the response when you contact Cybooks support.
