Get started

Authentication

Authenticate Xara business-resource requests using a Bearer API token.

Xara uses API tokens to authorize every request your server sends to the API. You can obtain your token from the Xara developer dashboard. The token also identifies your business, so invoice requests do not need a separate business ID.

Send the token

Include the token in the Authorization header using the Bearer scheme:

Authorization: Bearer YOUR_API_TOKEN

The adjacent example shows the complete header in a request to retrieve products.

The dashboard uses a masked placeholder in its starter request. Use your real token only in secure server-side code.

Which endpoints require it?

OperationAuthentication
Create a productBearer API token
Retrieve productsBearer API token
Create a ticketBearer API token
Retrieve ticket tiersBearer API token
Create an invoiceBearer API token
Reply as a chat assistantBearer API token
Receive a webhook (payments or chat assistants)No Bearer token; verify X-Xara-Signature

A webhook is the exception because it is an incoming request from Xara to your server, not a request your server sends to the API.

Keep tokens on your server

API tokens authorize access to business resources. Never place them in browser code, mobile application bundles, public repositories, screenshots, or support messages.

Store the token in an environment variable:

.env
XARA_API_TOKEN=your_token_here

Then read it only from your backend application.

The examples use placeholders. Never commit a real Xara API token to source control.

Authentication errors

A missing or invalid token causes an authentication error. Correct the token before sending the request again.

Check that:

  1. The header begins with Bearer .
  2. The token has no extra quotes or whitespace.
  3. You copied the token from the Xara developer dashboard.
Copyright © 2026