---
title: "POST /Clients"
method: POST
path: "/Clients"
tags: ["Clients"]
---

# POST /Clients

`POST /Clients`

## Request body

- CreateClientDto
  - `email` string, nullable
  - `firstName` string
  - `lastName` string
  - `phoneNumber` string, nullable
  - `address` string, nullable
  - `city` string, nullable
  - `state` string, nullable
  - `zipCode` string, nullable
  - `countryCode` string, nullable
  - `dateOfBirth` string, date-time, nullable
  - `accountStatus` string, nullable
  - `preferredContactMethod` string, nullable
  - `allowAppointmentReminders` boolean
  - `allowEmailMarketing` boolean
  - `allowPhoneCalls` boolean
  - `allowSmsMarketing` boolean
  - `communicationNotes` string, nullable
  - `emergencyContactName` string, nullable
  - `emergencyContactPhone` string, nullable
  - `emergencyContactEmail` string, nullable
  - `emergencyContactRelationship` string, nullable
  - `secondaryEmergencyContactName` string, nullable
  - `secondaryEmergencyContactPhone` string, nullable
  - `secondaryEmergencyContactEmail` string, nullable
  - `secondaryEmergencyContactRelationship` string, nullable
  - `preferredLanguage` string, nullable
  - `referralSource` string, nullable

## Response `200`

OK

- ClientResponseDto
  - `id` string
  - `email` string, nullable
  - `phoneNumber` string, nullable
  - `firstName` string
  - `lastName` string
  - `address` string, nullable
  - `city` string, nullable
  - `state` string, nullable
  - `zipCode` string, nullable
  - `countryCode` string, nullable — ISO 3166-1 alpha-2 country code (e.g. "US", "GB"). Defaults to clinic's region if null.
  - `dateOfBirth` string, date-time, nullable
  - `accountStatus` integer
  - `emergencyContact` EmergencyContactDto
    - `name` string, nullable
    - `phone` string, nullable
    - `email` string, nullable
    - `relationship` string, nullable
  - `secondaryEmergencyContact` SecondaryEmergencyContactDto — A client's secondary (backup) emergency contact — free-text, same shape as the primary one (PAW-650). Backed by the `SecondaryEmergencyContact*` columns on the client.
    - `name` string, nullable
    - `phone` string, nullable
    - `email` string, nullable
    - `relationship` string, nullable
  - `communicationPreferences` CommunicationPreferencesDto
    - `preferredMethod` integer
    - `allowAppointmentReminders` boolean
    - `allowEmailMarketing` boolean
    - `allowPhoneCalls` boolean
    - `allowSmsMarketing` boolean
    - `notes` string, nullable
  - `preferredLanguage` string, nullable
  - `referralSource` string, nullable
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

---

[API](https://skmtc.net/clinicos/apis/pawthosx-business-api-v1.md) · [All operations](https://skmtc.net/clinicos/apis/pawthosx-business-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clinicos/pawthosx-business-api-v1/revisions/e7d381a5453b/schema)