Integrate AI Receptionist into your application. Create receptionists, manage conversations, capture leads, and send SMS — all programmatically.
1. Get your API key from the Dashboard → API Keys page.
2. Include it as a Bearer token in all requests:
curl -X POST https://aireceptionist.fit/api/v1/chat \
-H "Authorization: Bearer air_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"receptionistId": "your_receptionist_id",
"message": "Hello, I need to book an appointment"
}'https://aireceptionist.fit/api/v1All API requests require a valid API key passed as a Bearer token in the Authorization header.
Authorization: Bearer air_your_api_key_hereAPI keys are prefixed with air_. You can generate and manage keys from your dashboard. Keys are shown only once on creation — store them securely.
Create, configure, and manage AI receptionists programmatically
Send messages and receive intelligent AI responses
Automatically extract and retrieve lead information
Send text messages from provisioned phone numbers
Monitor API usage, limits, and overage in real-time
Generate, manage, and revoke API keys from your dashboard
The API uses standard HTTP status codes:
| Status | Meaning |
|---|---|
| 200 | Success |
| 201 | Created |
| 400 | Bad Request — missing or invalid parameters |
| 401 | Unauthorized — invalid or missing API key |
| 403 | Forbidden — plan limit exceeded |
| 404 | Not Found — resource doesn\'t exist |
| 500 | Internal Server Error |
| 502 | AI service temporarily unavailable |