Saltar al contenido principal
POST
/
v1
/
institutional
/
accounts
Create a doctor account
curl --request POST \
  --url https://synapse.telepatia.ai/v1/institutional/accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "country": "COLOMBIA",
  "doctorSpecialties": [
    "CARDIOLOGY"
  ],
  "email": "dr.juan@clinica.com",
  "institutionalBranchName": "Sede Norte",
  "internalCode": "DOC-001",
  "language": "es",
  "nameFull": "Dr. Juan Pérez",
  "timeZone": "America/Bogota"
}
'
{
  "id": "<string>",
  "email": "<string>",
  "apiKey": "<string>",
  "internalCode": "DOC-001"
}

Autorizaciones

​
Authorization
string
header
requerido

Clave API enviada como token Bearer

Cuerpo

application/json

Request body for creating an institutional doctor account.

​
email
string
requerido
Maximum string length: 254
Ejemplo:

"dr.juan@clinica.com"

​
doctorSpecialties
string[]
requerido
Minimum array length: 1
Ejemplo:
["CARDIOLOGY"]
​
accountRole
string | null
Ejemplo:

"doctor"

​
country
string | null
Ejemplo:

"COLOMBIA"

​
language
string | null
Ejemplo:

"es"

​
timeZone
string | null
Ejemplo:

"America/Bogota"

​
nameFull
string | null
Maximum string length: 500
Ejemplo:

"Dr. Juan Pérez"

​
institutionalBranchName
string | null
Maximum string length: 255
Ejemplo:

"Sede Norte"

​
internalCode
string | null

Idempotency key scoped to the institution. Re-submitting the same value returns 409 if the account already exists.

Maximum string length: 128
Ejemplo:

"DOC-001"

Respuesta

Successful Response

Response body after creating an institutional doctor account.

​
id
string
requerido

Account publicId (acc_*). Use this as the identifier in subsequent API calls.

Ejemplo:

"acc_a1b2c3d4e5f6g7h8"

​
email
string
requerido
Ejemplo:

"dr.juan@clinica.com"

​
apiKey
string
requerido

Raw API key for this account. Shown only once — store it securely.

Ejemplo:

"<shown-once-store-securely>"

​
internalCode
string | null
Ejemplo:

"DOC-001"