Skip to main content
Use this endpoint to register a new practitioner. You must provide at least firstName and lastName. Optionally include the practitioner’s NPI, specialty, professional qualifications, preferred languages, and contact information.

​
Request

POST https://api.clinikapi.com/v1/practitioners

​
Headers

​
x-api-key
string
required
Your ClinikAPI secret key (clk_live_* or clk_test_*).
​
Content-Type
string
required
Must be application/json.

​
Body

​
firstName
string
required
Practitioner’s first name. Maximum 100 characters.
​
lastName
string
required
Practitioner’s last name. Maximum 100 characters.
​
prefix
string[]
Name prefixes such as Dr. or Prof..
​
suffix
string[]
Name suffixes such as MD, PhD, or FACC.
​
email
string
Practitioner’s email address.
​
phone
string
Practitioner’s phone number. Maximum 20 characters.
​
gender
string
Practitioner’s gender. One of: male, female, other, unknown.
​
birthDate
string
Date of birth in YYYY-MM-DD format.
​
npi
string
National Provider Identifier (US). Maximum 20 characters.
​
specialty
string
Primary specialty (e.g. Cardiology, Family Medicine). Maximum 200 characters.
​
qualifications
array
Professional qualifications. Maximum 20 items.
​
languages
string[]
BCP-47 language codes for languages the practitioner speaks (e.g. ["en", "es"]).
​
address
object
Practitioner’s address.

​
Response

Returns 201 Created with the new practitioner resource.
​
data.id
string
Generated practitioner ID (e.g. prac_xyz789).
​
data.firstName
string
Practitioner’s first name.
​
data.lastName
string
Practitioner’s last name.
​
data.npi
string
National Provider Identifier, if supplied.
​
data.specialty
string
Primary specialty, if supplied.
​
meta
object
Standard response metadata.

​
Examples

​
curl

curl -X POST https://api.clinikapi.com/v1/practitioners \
  -H "x-api-key: clk_live_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "firstName": "Alice",
    "lastName": "Chen",
    "prefix": ["Dr."],
    "suffix": ["MD", "FACC"],
    "email": "[email protected]",
    "phone": "+1-555-0200",
    "npi": "1234567890",
    "specialty": "Cardiology",
    "qualifications": [
      {
        "name": "Board Certified in Cardiovascular Disease",
        "issuer": "American Board of Internal Medicine",
        "identifier": "ABIM-12345"
      }
    ],
    "languages": ["en", "zh"]
  }'

​
TypeScript SDK

import { ClinikAPI } from "@clinikapi/sdk";

const client = new ClinikAPI({ apiKey: "clk_live_abc123" });

const practitioner = await client.practitioners.create({
  firstName: "Alice",
  lastName: "Chen",
  prefix: ["Dr."],
  suffix: ["MD", "FACC"],
  email: "[email protected]",
  npi: "1234567890",
  specialty: "Cardiology",
  qualifications: [
    {
      name: "Board Certified in Cardiovascular Disease",
      issuer: "American Board of Internal Medicine",
      identifier: "ABIM-12345",
    },
  ],
  languages: ["en", "zh"],
});

console.log(practitioner.data.id); // prac_xyz789