Skip to main content
POST
/
clients
/
{client}
cURL
curl --request POST \
  --url https://api.caspen.com/v1/clients/{client} \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "first_name": "<string>",
  "last_name": "<string>",
  "preferred_name": "<string>",
  "profession": "<string>",
  "email": "[email protected]",
  "date_of_birth": "2023-11-07T05:31:56Z",
  "sex": "<string>",
  "gender_identity": "<string>",
  "pronouns": "<string>",
  "privacy_policy_consent": "accepted",
  "emergency_contact_name": "<string>",
  "emergency_contact_phone": "<string>",
  "emergency_contact_relationship": "<string>",
  "notes": "<string>",
  "alert": "<string>",
  "referral_type_id": 123,
  "referral_description": "<string>",
  "referred_by_id": "<string>",
  "phone_number": "<string>",
  "intolerances": [
    "<string>"
  ],
  "address": {
    "line1": "<string>",
    "line2": "<string>",
    "city": "<string>",
    "state": "<string>",
    "postal_code": "<string>",
    "country_code": "<string>"
  },
  "tag_ids": [
    123
  ],
  "ndis_details": {
    "ndis_number": "<string>",
    "fund_management": "self_managed"
  },
  "medications": [
    {
      "name": "<string>",
      "dosage": "<string>"
    }
  ],
  "allergies": [
    {
      "name": "<string>",
      "reaction": "<string>"
    }
  ],
  "phone_numbers": [
    {
      "number": "<string>",
      "code": "<string>",
      "type": "mobile"
    }
  ]
}
'
{
  "id": "<string>",
  "title": "<string>",
  "first_name": "<string>",
  "last_name": "<string>",
  "preferred_name": "<string>",
  "profession": "<string>",
  "email": "<string>",
  "date_of_birth": "<string>",
  "sex": "<string>",
  "gender_identity": "<string>",
  "pronouns": "<string>",
  "privacy_policy_consent": "<string>",
  "medications": [
    {
      "name": "<string>",
      "dosage": "<string>"
    }
  ],
  "allergies": [
    {
      "name": "<string>",
      "reaction": "<string>"
    }
  ],
  "intolerances": [
    "<string>"
  ],
  "emergency_contact_name": "<string>",
  "emergency_contact_phone": "<string>",
  "emergency_contact_relationship": "<string>",
  "notes": "<string>",
  "alert": "<string>",
  "referral_type_id": "<string>",
  "referral_description": "<string>",
  "referred_by_id": "<string>",
  "phone_number": "<string>",
  "phone_numbers": [
    {
      "id": "<string>",
      "code": "<string>",
      "number": "<string>",
      "type": "<string>"
    }
  ],
  "address": {
    "line1": "<string>",
    "line2": "<string>",
    "city": "<string>",
    "state": "<string>",
    "postal_code": "<string>",
    "country_code": "<string>"
  },
  "tag_ids": [
    "<string>"
  ],
  "created_at": "<string>"
}

Path Parameters

​
client
string
required

The client ID

Body

application/json
​
title
string | null
​
first_name
string
​
last_name
string
​
preferred_name
string | null
​
profession
string | null
​
email
string<email> | null
​
date_of_birth
string<date-time> | null
​
sex
string | null
​
gender_identity
string | null
​
pronouns
string | null
​
privacy_policy_consent
enum<string>
Available options:
accepted,
rejected
​
emergency_contact_name
string | null
​
emergency_contact_phone
string | null
​
emergency_contact_relationship
string | null
​
notes
string | null
​
alert
string | null
Maximum string length: 500
​
referral_type_id
integer | null
​
referral_description
string | null
​
referred_by_id
string
​
phone_number
string | null
​
intolerances
string[] | null
​
address
object
​
tag_ids
integer[]
​
ndis_details
object
​
medications
object[] | null
​
allergies
object[] | null
​
phone_numbers
object[]

Response

ClientResource

​
id
string

The client's unique identifier.

​
title
string | null

The client's honorific title.

​
first_name
string

The client's given name.

​
last_name
string

The client's family name.

​
preferred_name
string | null

The client's preferred name.

​
profession
string | null

The client's profession or occupation.

​
email
string | null

The client's email address.

​
date_of_birth
string | null

The client's date of birth (ISO 8601).

​
sex
string | null

The client's sex assigned at birth.

​
gender_identity
string | null

The client's gender identity.

​
pronouns
string | null

The client's pronouns.

​
privacy_policy_consent
string | null

The client's privacy policy consent status.

​
medications
object[] | null

The client's medications.

​
allergies
object[] | null

The client's allergies.

​
intolerances
string[] | null

The client's intolerances.

​
emergency_contact_name
string | null

The client's emergency contact name.

​
emergency_contact_phone
string | null

The client's emergency contact phone number.

​
emergency_contact_relationship
string | null

The client's relationship to the emergency contact.

​
notes
string | null

The client's practitioner or admin notes.

​
alert
string | null

The client's alert message for staff.

​
referral_type_id
string | null

The client's referral type identifier.

​
referral_description
string | null

The client's referral description.

​
referred_by_id
string | null

The client's referring entity identifier.

​
phone_number
string | null

The client's primary phone number.

​
phone_numbers
object[]

A list of the client's additional phone numbers.

​
address
object

The client's address details.

​
tag_ids
string[]

The IDs of tags attached to the client.

​
created_at
string

The timestamp when the client was created (ISO 8601).