Pular para o conteúdo 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"
}

Autorizações

​
Authorization
string
header
obrigatório

Chave de API enviada como token Bearer

Corpo

application/json

Request body for creating an institutional doctor account.

​
email
string
obrigatório
Maximum string length: 254
Exemplo:

"dr.juan@clinica.com"

​
doctorSpecialties
string[]
obrigatório
Minimum array length: 1
Exemplo:
["CARDIOLOGY"]
​
accountRole
string | null
Exemplo:

"doctor"

​
country
string | null
Exemplo:

"COLOMBIA"

​
language
string | null
Exemplo:

"es"

​
timeZone
string | null
Exemplo:

"America/Bogota"

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

"Dr. Juan Pérez"

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

"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
Exemplo:

"DOC-001"

Resposta

Successful Response

Response body after creating an institutional doctor account.

​
id
string
obrigatório

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

Exemplo:

"acc_a1b2c3d4e5f6g7h8"

​
email
string
obrigatório
Exemplo:

"dr.juan@clinica.com"

​
apiKey
string
obrigatório

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

Exemplo:

"<shown-once-store-securely>"

​
internalCode
string | null
Exemplo:

"DOC-001"