---
title: "POST /practices/{practice_id}/appointments"
method: POST
path: "/practices/{practice_id}/appointments"
tags: ["appointments"]
---

# POST /practices/{practice_id}/appointments

`POST /practices/{practice_id}/appointments`

## Path parameters

- `practice_id` string, required

## Request body

- Appointment
  - `appointment_type` string, required
  - `billing_provider_npi` string — If provided, Collectly will look up imported providers by NPI instead of external_id. Do not provide both 'external_billing_provider_id' and 'billing_provider_npi'.
  - `client_id` unknown
  - `collectly_patient_id` integer
  - `collectly_primary_insurance_policy_id` integer
  - `collectly_secondary_insurance_policy_id` integer
  - `company_id` unknown
  - `created_at` string, date-time
  - `expected_copay_amount` unknown
  - `external_billing_provider_id` string
  - `external_billing_provider_name` string — If provided, Collectly will look up imported providers by name instead of external_id. Do not provide both 'external_billing_provider_id' and 'external_billing_provider_name'.
  - `external_id` string, required
  - `external_location_id` string
  - `external_location_name` string — If provided, Collectly will look up imported locations by name instead of external_id. Do not provide both 'external_location_id' and 'external_location_name'.
  - `external_patient_id` string
  - `external_provider_id` string
  - `external_provider_name` string — If provided, Collectly will look up imported providers by name instead of external_id. Do not provide both 'external_provider_id' and 'external_provider_name'.
  - `external_status` 'active' | 'cancelled' | 'rescheduled' | 'no_show', required
  - `id` integer
  - `metadata` object — Additional data to be stored with the appointment. This can be used to store any extra information that does not fit into the predefined fields.
  - `modified_at` string, date-time
  - `provider_npi` string — If provided, Collectly will look up imported providers by NPI instead of external_id. Do not provide both 'external_provider_id' and 'provider_npi'.
  - `service_date_end` string, required
  - `service_date_end_local` string, date-time
  - `service_date_start` string, required
  - `service_date_start_local` string, date-time
  - `timezone_local` string

## Response `200`

OK

- Appointment
  - `appointment_type` string, required
  - `billing_provider_npi` string — If provided, Collectly will look up imported providers by NPI instead of external_id. Do not provide both 'external_billing_provider_id' and 'billing_provider_npi'.
  - `client_id` unknown
  - `collectly_patient_id` integer
  - `collectly_primary_insurance_policy_id` integer
  - `collectly_secondary_insurance_policy_id` integer
  - `company_id` unknown
  - `created_at` string, date-time
  - `expected_copay_amount` unknown
  - `external_billing_provider_id` string
  - `external_billing_provider_name` string — If provided, Collectly will look up imported providers by name instead of external_id. Do not provide both 'external_billing_provider_id' and 'external_billing_provider_name'.
  - `external_id` string, required
  - `external_location_id` string
  - `external_location_name` string — If provided, Collectly will look up imported locations by name instead of external_id. Do not provide both 'external_location_id' and 'external_location_name'.
  - `external_patient_id` string
  - `external_provider_id` string
  - `external_provider_name` string — If provided, Collectly will look up imported providers by name instead of external_id. Do not provide both 'external_provider_id' and 'external_provider_name'.
  - `external_status` 'active' | 'cancelled' | 'rescheduled' | 'no_show', required
  - `id` integer
  - `metadata` object — Additional data to be stored with the appointment. This can be used to store any extra information that does not fit into the predefined fields.
  - `modified_at` string, date-time
  - `provider_npi` string — If provided, Collectly will look up imported providers by NPI instead of external_id. Do not provide both 'external_provider_id' and 'provider_npi'.
  - `service_date_end` string, required
  - `service_date_end_local` string, date-time
  - `service_date_start` string, required
  - `service_date_start_local` string, date-time
  - `timezone_local` string

---

[API](https://skmtc.net/collectly/apis/partners1.md) · [All operations](https://skmtc.net/collectly/apis/partners1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/collectly/partners1/revisions/5363b9dbd7f6/schema)