DevelopersChanges data

create_business

API reference — one of six tools an AI assistant can call on an Avrosh account.

What it does

Create a new business on this account. Ask the human for the name, timezone (IANA, e.g. 'Asia/Jakarta') and language first - do not invent them. call_types picks what the AI handles on the phone: any of bookings, orders, jobs. Leave call_types out and the AI answers questions only, which is the safe default for a business you are still setting up. The business is created immediately and cannot be un-created from here.

This is the exact text the model reads before deciding to call.

Parameters

namestringrequired

The business name as its customers know it.

timezonestringrequired

IANA timezone, e.g. 'Asia/Jakarta'.

languagestringrequired

Default language code, e.g. 'id' or 'en'.

currencystringoptional

ISO 4217, e.g. IDR, USD. Ask; never assume.

countrystringoptional

ISO 3166-1 alpha-2, e.g. ID, SG.

call_typesarrayoptional

Any of: bookings, orders, jobs. Omit for questions-only.

Request

curl -X POST https://us.avrosh.com/mcp \
  -H "Authorization: Bearer $AVROSH_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"create_business","arguments":{"name":"Northgate Barbers","timezone":"Asia/Jakarta","language":"id","currency":"IDR","call_types":["bookings"]}}}'

Response

The result arrives as an MCP content block; the JSON below is what the text field parses to.

{
  "business": {
    "id": "926135ac-…",
    "name": "Northgate Barbers",
    "slug": "northgate-barbers-a1b2"
  },
  "next": "Open the dashboard to add the knowledge base, or call get_business to see what is still unset."
}

Authentication

Every request carries Authorization: Bearer avk_…. Create a key in the Avrosh dashboard under Docs; it is shown once, because only its hash is stored.

One key reaches every business on the account that made it, and no others. There are no scopes to configure and nothing to switch on — a connected assistant receives the whole toolset. What bounds it is whose account the key belongs to, which is enforced in the database rather than by a permission anybody sets.

curl https://us.avrosh.com/mcp \
  -H "Authorization: Bearer $AVROSH_KEY"