---
title: "Create Patient"
method: PUT
path: "/api/v1/patient"
tags: ["api"]
---

# Create Patient

`PUT /api/v1/patient`

This endpoint generates a patient record in the Truepill ecosystem.<br/><br/>Upon a successful request, the endpoint returns a `patient_token` for you to reference in subsequent API requests that require this field.<br/><br/>The `patient_token` that is returned upon successfully creating a patient record can be used with many of the other endpoints to continue referencing the same record.<br/><br/>If the patient information in the request body matches the information in an existing patient record, the existing `patient_token` will be returned in the API response.<br/><br/>The address and phone number provided should be the same as the information provided to the prescriber on the e-Script. These attributes are only used for matching purposes.

## Request body

- Model230
  - `guardian` string
  - `prefix` 'Mr.' | 'Ms.' | 'Mrs.' | 'Miss' | 'Ms' | 'Prof' | 'Sir' — Patient title
  - `suffix` 'Jr.' | 'Sr.' | 'I' | 'II' | 'III' | 'IV' | 'V' — Suffix which qualifies a person
  - `first_name` string, required — Patient first name
  - `last_name` string, required — Patient last name
  - `gender` 'male' | 'female' | 'unknown', required — Patient gender
  - `dob` string, date, required — Patient's date of birth
  - `zip` string — Patient’s zip code
  - `species` 'Human' | 'Crocodile' | 'Frog' | 'Iguana' | 'Lizard' | 'Snake' | 'Tortoise' | 'Turtle' | 'Spider' | 'Other Arthopoda' | 'Chicken' | 'African Goshawk' | 'Budgerigar' | 'Cockatiel' | 'Cockatoo' | 'Common Canary' | 'Crow' | 'Duck' | 'Eagle' | 'Goose' | 'Guinea Fowl' | 'Kestrel' | 'Kite' | 'Macaw' | 'Ostrich' | 'Other Aves' | 'Owl' | 'Parakeet' | 'Parrot' | 'Partridge' | 'Peregrin Falcon' | 'Pheasant' | 'Pigeon' | 'Quail' | 'Snipe' | 'Sparrow' | 'Starling' | 'Swan' | 'Turtle Dove' | 'Bison' | 'Cattle/Bovine' | 'Buffalo' | 'Other Bovinae' | 'Alpaca' | 'Camel' | 'Llama' | 'Other Camelidae' | 'Dog/Canine' | 'Fox' | 'Jackal' | 'Raccoon Dog' | 'Wolf' | 'Other Caprinae' | 'Goat/Carpine' | 'Sheep/Ovine' | 'Elk' | 'Moose' | 'Fallow' | 'Other Cervidae' | 'Red Deer' | 'Reindeer' | 'Roe Deer' | 'Donkey/Asinine' | 'Horse/Equine' | 'Hybrid' | 'Other Equidae' | 'Zebra' | 'Bobcat' | 'Cougar' | 'Puma' | 'European Lynx' | 'Cat/Feline' | 'Jaguar' | 'Leopard' | 'Lion' | 'Other Felidae' | 'Tiger' | 'Wild Cat' | 'European Rabbit' | 'Hare' | 'Other Leporidae' | 'Bivalvia' | 'Cephalopoda' | 'Other Mollusca' | 'Badger' | 'Ferret' | 'Mink' | 'Other Mustelidae' | 'Bat' | 'Bear' | 'Hedgehog' | 'Monkey' | 'Other Mammalia' | 'Arctic Char' | 'Atlantic Salmon' | 'Brill' | 'Carp' | 'Catfish' | 'Cod' | 'Crucian Carp' | 'European Eel' | 'Gilthead' | 'Goldfish' | 'Gudgeon' | 'Halibut' | 'Largemouth Bass' | 'Mullet' | 'Other Pisces' | 'Perch' | 'Pike' | 'Roach' | 'Sea Bream' | 'Seabass' | 'Sharpsnout Seabream' | 'Sole' | 'Sturgeon' | 'Tench' | 'Trout' | 'Turbot' | 'Rockfish/Wolffish' | 'Beaver' | 'Chinchilla' | 'Dormouse' | 'Dwarf Hamster' | 'European Hamster' | 'Gerbil' | 'Guinea Pig' | 'House Mouse' | 'Other Rodentia' | 'Rat' | 'Russian Hamster' | 'Syrian Hamster' | 'Golden Hamster' | 'Vole' | 'Other Suidae' | 'Pig/Porcine' | 'Wild Boar' | 'Addax'
  - `company` string — Name of company associated with patient (if applicable)
  - `street1` string — Street 1 of patient’s address
  - `street2` string — Street 2 of patient’s address (if applicable)
  - `city` string — City of patient’s address
  - `state` string — State of patient’s address, two-letter abbreviation
  - `country` string
  - `phone` string — Patient’s phone number
  - `email` string — Patient’s email address
  - `ssn` string — Social Security Number
  - `ssn_serial` string — Social Security Number (last 4 digits)
  - `communications_opt_in` boolean
  - `language_preference` string — Patient’s preferred language
  - `id_image` string — URL for image of user ID
  - `mbi` string — Medicare Beneficiary ID
  - `viewed_notice_of_privacy_practices` boolean
  - `viewed_notice_of_privacy_practices_date` string — Date NOPP was received

## Response `201`

Created

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.dev/truepill/apis/truepill-api-documentation.md) · [All operations](https://skmtc.dev/truepill/apis/truepill-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/truepill/truepill-api-documentation/revisions/d9aaa355c1e0/schema)