Quickstart

You will create a test tenant, set up its receptionist, and receive a webhook. Test keys never cost anything.

1. Get a test key

Create a developer account (choose "A software company"), open API keys in the console and create a Test key. It starts with sk_test_ and is shown once.

export SANAA_KEY=sk_test_...

2. Add a tenant

A tenant is one of your customers. Use your own id for it. The sandbox backend needs no connector, so you can try everything first.

curl https://api.getsanaa.com/api/v1/tenants \
  -H "Authorization: Bearer $SANAA_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "external_id": "customer_1042", "booking_backend": "sandbox" }'

Sending the same external_id again returns the same tenant (200 instead of 201).

3. Set up its receptionist

curl -X POST https://api.getsanaa.com/api/v1/tenants/TENANT_ID/provision \
  -H "Authorization: Bearer $SANAA_KEY"

This creates the voice assistant on the current engine release. Run it again after changing settings or after the business changes its services, staff or hours.

4. Receive events

curl https://api.getsanaa.com/api/v1/webhook_endpoints \
  -H "Authorization: Bearer $SANAA_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://yourapp.com/webhooks/sanaa", "events": ["booking.created", "call.ended"] }'

The signing secret is in the response, once. See Webhooks to verify deliveries.

5. Connect your booking system

When you are ready for real bookings, build the booking connector, register it, and run the conformance test. A live key then creates live tenants that book into your system.

Prefer to let an AI coding tool do it? Use the MCP server.