---
title: "Open one of a clinic's booking routes"
method: POST
path: "/api/public/dental-network/tools/prepare_dental_practice_action"
---

# Open one of a clinic's booking routes

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

## Request

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

Creates a short-lived action for one capability the clinic's action options list (its scheduler page, a Xona request, a request form, a call or its website) and returns the URL of the page for it. A capability the clinic does not list is refused. A connected practice's time from list_xona_booking_slots is held with hold_xona_booking_slot, not through this tool.

## Request body

- object
  - `capability` 'public_provider_booking' | 'public_booking_handoff' | 'xona_email_appointment_request' | 'external_request_form' | 'call_clinic' | 'visit_clinic_website', required
  - `practice_slug` string, required

## Response `200`

Open one of a clinic's booking routes

- object
  - `action` object, required
  - `conversational_next_tool` string
  - `manual_review_required` boolean, required
  - `next_step` 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)