At a glance
- Availability: Experimental (how to enable).
- Auth: API key.
- Connection: The key from
XENTRAL_API_TOKENis sent as theBearerprefixedAuthorizationheader. - Docs: https://developer.xentral.com/reference/authentication
Credentials
Set these per environment. See Connect an integration.Setup
- Get a Xentral instance: Sign up for a Xentral trial at https://xentral.com. Your instance gets its own host like mycompany.xentral.biz - all API calls go to that host.
- Create a Personal Access Token: In your Xentral instance, create a Personal Access Token (PAT) via the API token settings (see https://help.xentral.com/hc/en-us/articles/22627542067740). Grant read scopes for sales orders, products, and customers, plus create scope for sales orders if you want to import orders.
- Store the token: Add XENTRAL_API_TOKEN to your .env file. It is sent as an Authorization: Bearer header on every request.
- Verify access: Run the List Sales Orders tool with your instance host (e.g. mycompany.xentral.biz) as instanceHost.
- Every tool takes an instanceHost parameter - your instance subdomain such as mycompany.xentral.biz (custom domains are also supported)
- PAT scopes are granted per resource group (CRM, products, accounting, …) with separate read/create/update/delete permissions
- Sales orders use the v1 API; products and customers use the newer v2 API endpoints
- List responses wrap results in a data array with pagination info in extra
Tools
Example prompts
- List my Xentral sales orders with status created or released and summarize them by customer and value.
- Find a product in Xentral by name or number and show its details.
- Create a new sales order in Xentral for a customer and products I specify.