AISARAISAR

Quickstart

Connect to the AISAR API in five minutes: create a token and make your first request.

The AISAR API is the REST interface to your AISAR workspace: conversations, contacts, channels, deals, funnels, broadcasts and message templates. External systems (a CRM, an AI assistant, your own backend) can use it to read company data and send messages on behalf of connected channels, and use webhooks to receive events in real time.

The API is available on the Business plan (the api feature). On lower plans requests made with an API token are rejected with a 403 "Feature not available on your plan" error.

Base URL

All REST API requests go to:

text
https://api.aisar.app/v1

Step 1 — create an API token

In the company cabinet go to Settings → Systems → API and create a new token. AISAR automatically provisions a service account bound to your company and issues it a Bearer token — it is shown only once, so copy it immediately.

The token grants access to the entire company workspace (the service account is created with an admin role). Treat it like a password and never embed it in client-side code.

Step 2 — your first request

Verify the token with a GET /v1/me request — it returns the service account profile and the current company:

Request
curl https://api.aisar.app/v1/me \
  -H "Authorization: Bearer YOUR_API_TOKEN"
Response
{
  "data": {
    "id": 123,
    "name": "API token",
    "email": "api-01hz...@service.aisar.app",
    "current_company_id": 45,
    "roles": ["admin"]
  }
}

Next, fetch the company's list of conversations:

List conversations
curl https://api.aisar.app/v1/conversations \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Step 3 — where to go next

  • The Authentication guide — the Bearer header, token management, rate limits and 401/429 handling.
  • The REST reference — every endpoint group: conversations, messages, contacts, channels, templates, deals, funnels, broadcasts and more.
  • The Webhooks guide — how to subscribe to events and verify delivery signatures.
  • The "Sending messages from your system" walkthrough — a step-by-step integration example: find a contact, pick a channel, send a text or a template.
  • The MCP servers guide — how to connect an AI agent to your AISAR workspace using the same API token.