Upload recordings
Import audio using a hosted media URL.
Attach audio to an appointment
Use Create or update an appointment and include media_url. The URL must point to a hosted audio file that Rilla can retrieve.
Appointment with hosted audio
curl --request POST \
--url 'https://api.apirilla.com/custom/appointment' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"event_id": "appt-1234",
"user_email": "alex@example.com",
"start_time": "2026-09-20 14:00:00",
"end_time": "2026-09-20 15:00:00",
"title": "Home estimate — Jordan Lee",
"customer": {
"id": "customer-123",
"name": "Jordan Lee"
},
"media_url": "https://your-storage.example.com/recordings/appt-1234.mp3",
"recording_type": "APPOINTMENT_AUDIO"
}'Replace media_url with a reachable audio file.
Choose the recording type
| Type | Use case |
|---|---|
APPOINTMENT_AUDIO | An in-person appointment recording. |
CALL_AUDIO | A dialer call. |
CALL_AUDIO_WITH_LOCATION | A dialer call assigned through a Voice-ID location group. Include location and confirm setup with Rilla. |
Confirm receipt and processing
A successful appointment request confirms receipt, not completed audio processing. Inspect the Custom API Debugger for appointment data, and use webhooks or data export to observe processed conversations.
Receive a processing event