---
title: "Add a person"
method: POST
path: "/v1/customers"
---

# Add a person

`POST /v1/customers`

## Request

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

## Request body

- object
  - `name` string, required
  - `phone` union
    - string, nullable
    - ''
  - `email` union
    - string, email, nullable
    - ''
  - `date_of_birth` union
    - string, nullable
    - ''
  - `student_name` union
    - string, nullable
    - ''
  - `notes` string, nullable
  - `tags` string[], nullable
  - `dietary` string, nullable

## Response `200`

Default Response

- object
  - `id` string, required
  - `name` string, required
  - `phone` string, nullable, required
  - `email` string, nullable, required
  - `date_of_birth` union, required
    - string
    - string, date-time
  - `notes` string, nullable, required
  - `tags` string[], nullable, required
  - `dietary` string, nullable
  - `student_name` string, nullable
  - `sources` string[], nullable

---

[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)