# POST /visits
URL: https://developers.vsee.io/api/visit-api/post/visits
operationId: createAppointment
Auth: User Token — Requires a user access token from login or SSO.

Create an appointment

Create a new scheduled appointment for a patient with a provider

Parameters:
- X-ApiToken (header, string, required) — API token
- X-AccountCode (header, string, required) — Account code
- member_id (query, string, optional) — The ID of the visiting patient (optional)
- slot_start (query, integer, required) — UNIX timestamp of appointment beginning
- slot_end (query, integer, required) — UNIX timestamp of appointment ending
- room_code (query, string, required) — Room code (required)
- type (query, integer, required) — Visit type: 2=scheduling
- intake_id (query, string, required) — The ID of the intake
- provider_id (query, string, optional) — The ID of the provider (optional)

Responses:
- 200 — Appointment created successfully
```json
{
  "data": {
    "member_id": 17778181,
    "provider_id": 12456470,
    "account_code": "vclinic",
    "code": "615f2e2eabc46ad94e9b6457b11",
    "start": 1631628616,
    "end": 1631628916,
    "type": 2,
    "status": 30,
    "room_code": "vclinicroom",
    "created": 1633627694,
    "modified": 1633630312,
    "provider": {
      "id": "12456470",
      "email": "doctor@vseelab.com",
      "full_name": "Dr. Anton Provider"
    },
    "member": {
      "id": "17778181",
      "email": "patient@vseelab.com",
      "full_name": "Anton Test"
    },
    "intake_id": "615f2de7-8ab8-48d3-80d8-53f564457b11"
  }
}
```
- 400 — Bad request - missing required parameters
```json
{
  "error": "Unauthorized",
  "message": "Invalid or missing API token"
}
```
- 401 — Unauthorized
```json
{
  "error": "Unauthorized",
  "message": "Invalid or missing API token"
}
```