Skip to main content
POST
/
v1
/
practitioners
Create practitioner
curl --request POST \
  --url https://api.clinikapi.com/v1/practitioners \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "firstName": "<string>",
  "lastName": "<string>",
  "prefix": [
    "<string>"
  ],
  "suffix": [
    "<string>"
  ],
  "email": "[email protected]",
  "phone": "<string>",
  "birthDate": "<string>",
  "npi": "<string>",
  "specialty": "<string>",
  "qualifications": [
    {
      "name": "<string>",
      "issuer": "<string>",
      "period": {
        "start": "<string>",
        "end": "<string>"
      },
      "identifier": "<string>"
    }
  ],
  "languages": [
    "<string>"
  ],
  "address": {
    "line": [
      "<string>"
    ],
    "city": "<string>",
    "state": "<string>",
    "postalCode": "<string>",
    "country": "<string>"
  },
  "photo": {
    "url": "<string>",
    "data": "<string>",
    "contentType": "<string>"
  }
}
'
{
  "data": "<unknown>",
  "meta": {
    "requestId": "req_k8f3a7x2",
    "timestamp": "2023-11-07T05:31:56Z",
    "status": 200,
    "rateLimitTotal": 123,
    "rateLimitRemaining": 123,
    "rateLimitReset": 123
  }
}

Authorizations

x-api-key
string
header
required

Your ClinikAPI secret key (clk_live_* or clk_test_*)

Body

application/json
firstName
string
required
Maximum string length: 100
lastName
string
required
Maximum string length: 100
prefix
string[]

Name prefixes (e.g. Dr., Prof.)

suffix
string[]

Name suffixes (e.g. MD, PhD, FACC)

email
string<email>
phone
string
Maximum string length: 20
gender
enum<string>
Available options:
male,
female,
other,
unknown
birthDate
string
npi
string

National Provider Identifier (US)

Maximum string length: 20
specialty
string

Primary specialty (e.g. Cardiology, Family Medicine)

Maximum string length: 200
qualifications
object[]
Maximum array length: 20
languages
string[]

BCP-47 language codes

address
object
photo
object

Practitioner photo

Response

Practitioner created

data
any

The resource or result payload

meta
object