Create a doctor account
Create a new doctor account for the authenticated institution. If internalCode is provided it acts as an idempotency key — submitting the same value twice returns 409.
Authorizations
API key passed as a Bearer token
Body
Request body for creating an institutional doctor account.
254"dr.juan@clinica.com"
Accepts either the specialty key ('CARDIOLOGY') or value ('cardiology'); always persisted as the value.
1acupuncture, alternativeMedicine, ayurvedicMedicine, chiropractic, herbalMedicine, homeopathy, naturopathy, traditionalChineseMedicine, cosmeticDentistry, dentistry, developmentalBehavioralPediatrics, endodontics, forensicDentistry, maxillofacialProsthodontics, oralMaxillofacialSurgery, oralMedicine, oralPathology, oralSurgery, orthodontics, pediatricDentistry, periodontics, prosthodontics, addictionPsychiatry, adolescentMedicine, aerospaceMedicine, allergyImmunology, andrology, anesthesiology, anesthesiologyCriticalCare, bariatricSurgery, breastRadiology, breastSurgery, cardiacSurgery, cardiovascularSurgery, cardiology, cardiovascularDisease, cardiovascularRiskProgram, childAbusePediatrics, childAdolescentPsychiatry, childNeurology, childWelfareSocialWork, clinicalNeurophysiology, clinicalSocialWork, colorectalSurgery, communityMedicine, communitySocialWork, consultationLiaisonPsychiatry, cosmeticDermatology, craniofacialTrauma, dermatology, dermoscopy, diabetes, diagnosticRadiology, electrophysiology, emergencyCriticalCare, emergencyMedicine, emergencyPsychiatry, endocrineSurgery, endocrinology, epilepsy, facialPlasticSurgery, familyMedicine, familySocialWork, footAnkleSurgery, forensicPsychiatry, forensicSocialWork, gastroenterology, generalMedicine, generalMedicinePsychiatry, generalSurgery, geriatricMedicine, geriatricPsychiatry, geriatricSocialWork, ginecology, gynecologicOncology, gynecologicSurgery, gynecology, handSurgery, headNeckSurgery, headacheMedicine, heartFailureTransplantCardiology, hematology, hepatobiliarySurgery, hipKneeSurgery, hospitalist, infectiousDisease, internalCriticalCare, internalMedicine, interventionalCardiology, interventionalRadiology, maternalFetalMedicine, medicalSocialWork, militarySocialWork, minimallyInvasiveGynecologicSurgery, mohsSurgery, musculoskeletalRadiology, neonatology, nephrology, neurocriticalCare, neuroimmunology, neurology, neuromuscularMedicine, neuroradiology, neurorehabilitation, neurosurgery, neurotology, nuclearMedicine, obstetrics, obstetricsGynecology, occupationalMedicine, occupationalSocialWork, oculoplasticSurgery, oncology, oncologySocialWork, ophthalmology, orthopedicHandSurgery, orthopedicSportsMedicine, orthopedicTrauma, orthopedics, otolaryngology, painMedicine, palliativeMedicine, palliativeSocialWork, pediatricAllergyImmunology, pediatricAnesthesiology, pediatricCardiology, pediatricCriticalCare, pediatricDermatology, pediatricEmergencyMedicine, pediatricEndocrinology, pediatricENT, pediatricGastroenterology, pediatricHematologyOncology, pediatricInfectiousDisease, pediatricNephrology, pediatricNeurology, pediatricCardiacSurgery, pediatricOncology, pediatricOphthalmology, pediatricOrthopedics, pediatricPalliativeCare, pediatricPulmonology, pediatricRadiology, pediatricRheumatology, pediatricSocialWork, pediatricSurgery, pediatricTrauma, pediatricUrology, pediatrics, perinatalPsychiatry, physicalMedicineRehab, plasticSurgery, prenatalCareProgram, preventiveMedicine, psychiatricSocialWork, psychiatry, psychosomaticMedicine, publicHealth, pulmonaryDisease, pulmonology, radiationOncologist, radiationOncology, reproductiveEndocrinology, retinaSurgery, rheumatology, riasProgram, manager, schoolSocialWork, shoulderElbowSurgery, sleepMedicine, socialWork, spinalCordInjury, spinalTrauma, spineSurgery, sportsMedicine, substanceAbuseSocialWork, surgicalOncology, telemedicine, thoracicSurgery, transplantHepatology, transplantSurgery, traumaSurgery, traumatology, triage, unknown, urgentCare, urologicOncology, urology, vascularSurgery, nursing, clinicalNutrition, eatingDisorderNutrition, gastroenterologicNutrition, geriatricNutrition, nutrition, oncologyNutrition, pediatricNutrition, renalNutrition, sportsNutrition, clinicalPsychology, counselingPsychology, developmentalPsychology, forensicPsychology, geropsychology, healthPsychology, industrialOrganizationalPsychology, militaryPsychology, neuropsychology, positivePsychology, psychology, rehabilitationPsychology, schoolPsychology, sportsPsychology, occupationalTherapy, physicalTherapy, respiratoryTherapy, speechTherapy, therapy, other Country as ISO 3166-1 alpha-2 (e.g. 'CO', 'BR'). Also accepts alpha-3 ('COL') or the English country name ('COLOMBIA'); all are normalized to the alpha-2 code Telepatia stores. Omit to inherit the institution's country.
"CO"
Account UI/content language as ISO 639-1 (e.g. 'es', 'pt', 'en'). Omit to inherit the institution's language.
"es"
IANA time zone (e.g. 'America/Bogota', 'America/Sao_Paulo'). Omit to inherit the institution's time zone.
"America/Bogota"
500"Dr. Juan Pérez"
255"Sede Norte"
Idempotency key scoped to the institution. Re-submitting the same value returns 409 if the account already exists. Omit to have the server generate a UUID v7 (no idempotency when generated); the value is returned in the response.
128"DOC-001"
Optional API key settings. Omit to mint a key valid for 365 days (1 year).
Response
Successful Response
Response body after creating an institutional doctor account.
Account publicId (acc_*). Use this as the identifier in subsequent API calls.
"acc_a1b2c3d4e5f6g7h8"
"dr.juan@clinica.com"
Raw secret API key for this account. Shown only once — store it securely.
"<shown-once-store-securely>"
Institution-scoped code for this account. Echoes the request value when supplied; otherwise a server-generated UUID v7. Always present — store it to fetch the account later via GET /accounts/{internalCode}.
"DOC-001"
UTC timestamp when this API key expires. Always present for institutional keys.
"2027-06-17T00:00:00Z"
API key lifetime in days that was applied (the validForDays used, default 365).
365
Raw publishable (pk_) key for the browser/embed exchange flow. Exchange-only (cannot call the API directly) and shown only once — minted alongside the secret key.
"<shown-once-store-securely>"