---
title: "Book a slot for a person, by name and WhatsApp number"
method: POST
path: "/v1/appointments"
---

# Book a slot for a person, by name and WhatsApp number

`POST /v1/appointments`

## Request

- Base URL: `https://api.octapi.app`
- URL: `https://api.octapi.app/v1/appointments`
- Auth: HTTP bearer

## Request body

- object
  - `offering_id` string, uuid, required
  - `provider_id` string, uuid, nullable
  - `starts_at` string, date-time, required
  - `name` string, required
  - `phone` string, required
  - `notes` union
    - string, nullable
    - ''

## Response `200`

Default Response

- object
  - `id` string, required
  - `service_name` string, required
  - `provider_name` string, required
  - `starts_at` union, required
    - string
    - string, date-time
  - `ends_at` union, required
    - string
    - string, date-time
  - `status` string, required

---

[API](https://skmtc.dev/octapi/apis/octapi-api.md) · [All operations](https://skmtc.dev/octapi/apis/octapi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/octapi/apis/octapi-api/revisions/580afda787d2?raw)