Berri Forge
Build with Berri
Explore the organisation API and connect your own software to Berri Desk.
White-label WhatsApp Business API
Ask your organisation administrator to enable the Business API and issue an operator key. Use the organisation’s API URL and a synthetic customer ID to try this from a server you control.
curl "$BERRI_API_URL/v1/messages" \
-H "X-API-Key: $BERRI_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"userId":"demo-customer","text":"What are your hours?","webhook":false}'
The API returns a reply to your application. Connect your own approved WhatsApp Business channel in Berri Desk to serve customers under your company brand.
Terminal with Berri Code
From the Berri source checkout with Node.js 20 or newer:
node cli/berri.mjs --help
node cli/berri.mjs "Explain how GST invoices work"Planned package quickstart: npx @berri/cli. Use the source command until a public package is available.
JavaScript and Python SDKs
Use a server-side key. For JavaScript, run an ESM script from the source checkout:
import { BerriAdminClient } from './admin-site-and-sdks/sdk-js/src/index.mjs';
const client = new BerriAdminClient({
baseUrl: process.env.BERRI_API_URL,
apiKey: process.env.BERRI_API_KEY,
});
console.log(await client.health.check());For Python, install ./admin-site-and-sdks/sdk-python with pip and import BerriAdminClient from berri_admin.
n8n and MCP
For n8n, install the n8n-nodes-berri package from the source checkout. Configure the API URL, organisation ID and API key, then test the Berri node with the overview operation.
For MCP, point your client at the enabled /mcp endpoint with a scoped MCP key and start with tools/list.
OpenAPI explorer
Filter the API reference by method, path or operation. This explorer reads the local contract and makes no API calls.
Download OpenAPI YAMLLoading the API reference…