---
title: "Start a dental appointment request"
method: POST
path: "/api/public/dental-network/tools/start_dental_request"
---

# Start a dental appointment request

`POST /api/public/dental-network/tools/start_dental_request`

## Request

- Base URL: `https://book.xonark.com`
- URL: `https://book.xonark.com/api/public/dental-network/tools/start_dental_request`
- Auth: none required

Start an appointment request for Xona to send to the selected clinic (by email, or through the clinic's own website form). It takes the patient's details and preferred times. Xona emails the patient a link that shows the exact request; the request goes to the clinic only when the patient presses "Send this request" there, or enters the email's code on continue_url. The result carries consent_text and continue_url; confirm_dental_request reports the status. Use it where list_dental_practice_actions marks xona_email_appointment_request as completes_in_conversation.

## Request body

- object
  - `note` string
  - `patient_email` string, email, required: The patient's own email; the link to send the request goes there
  - `patient_name` string, required: The patient's name as they typed it
  - `patient_phone` string: The patient's phone as they typed it; required when the clinic's website form needs one
  - `practice_slug` string, required
  - `preferred_window` string, required: When the patient is free, in their words
  - `service_category` 'checkup_cleaning' | 'children' | 'cosmetic' | 'implants' | 'new_patient' | 'orthodontics' | 'other' | 'tooth_pain', required

## Response `200`

Start a dental appointment request

- object
  - `action` object, required
  - `consent_text` string, required
  - `consent_version` string, required
  - `next_step` string, required
  - `practice` object, required
    - `name` string, required
    - `slug` string, required
  - `verification` string, required

## Other responses

- `400`: Invalid request or action state
- `403`: Public write is disabled, or not a member of the claiming account
- `404`: Dental resource not found
- `410`: Dental action expired
- `413`: Request body too large
- `429`: Rate limit exceeded
- `502`: Clinic booking provider is unavailable
- `503`: Gateway temporarily unavailable
- `504`: Clinic booking provider timed out

---

[API](https://skmtc.dev/xonark/apis/xona-dental-gateway-public-api.md) · [All operations](https://skmtc.dev/xonark/apis/xona-dental-gateway-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/xonark/apis/xona-dental-gateway-public-api/revisions/886252359184?raw)