Onboarding

Onboarding means setting up the workspace before doctors use Tiep.

The setup order is simple:

Step 1: sign in

Tiep gives the first admin access to the platform. That admin can create facilities, invite members, and configure integrations.

Use the platform here:

https://platform.tiep.ai

Step 2: understand the main objects

Object	Simple meaning	Example
Organization	The customer workspace	Hospital Group A
Facility	One working site or department	Madrid clinic, Cardiology unit
Member	A human platform user	Admin, manager, viewer
Doctor profile	A doctor identity used during consultations	doctor-123, Dr. Smith
Form	The data Tiep should extract	Shoulder visit form
Concept set	A reusable list of coded choices	Medication list, ICD codes

Step 3: create facilities

A facility is where most configuration lives. If two clinics need different doctors, forms, API keys, or webhooks, create two facilities.

You can create a facility in the platform or with the API.

Create a facility in the platform

1. Go to Facilities.
2. Select New facility.
3. Enter the facility name and address details.
4. Save it.

Create a facility with the API

Use an organization API key when you want another system to create facilities.

curl -X POST "https://api.tiep.ai/v1/facilities" \
  -H "X-API-Key: $ORGANIZATION_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Madrid clinic",
    "city": "Madrid",
    "country": "Spain",
    "payload_type": "SIMPLE"
  }'

Step 4: invite members

Members are people who manage the platform. They are not the same thing as doctor profiles.

Example:

Person	Platform member?	Doctor profile?
Hospital IT admin	Yes	Usually no
Medical director	Yes	Maybe
Doctor using Tiep	Maybe	Yes

Read organizations and members for roles and facility access.

Step 5: create doctor profiles

A doctor profile is the clinical identity used in consultations. It can be created in the platform or by API.

curl -X POST "https://api.tiep.ai/v1/facilities/12/doctors" \
  -H "X-API-Key: $FACILITY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "doctor-123",
    "name": "Dr. Anna Smith",
    "email": "[email protected]",
    "specialties": ["ORTHOPEDICS"]
  }'

Read doctor profiles before inviting real doctors.

Step 6: create forms and concept sets

Forms tell the AI what to extract. Concept sets give the AI controlled choices.

Example:

• Form: Shoulder follow-up
• Field: Diagnosis
• Concept set: ICD-10 shoulder codes
• Stored value: M75.1
• Label shown to doctor: Rotator cuff tear

Read forms and concept sets carefully. They are the most important part of the setup.

Step 7: configure integration

If Tiep must send reports back to an HIS, configure integration settings on the facility.

You need:

• A webhook URL.
• A webhook secret.
• A payload type, usually SIMPLE or HL7_V2.

Read integration settings and payload format.