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.
4. Choose the starter specialties. All defaults are selected initially.
5. 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",
    "specialties": [
      {
        "name": "Orthopedics",
        "snomed_code": "394801008"
      },
      {
        "name": "General medicine",
        "snomed_code": "394802001"
      }
    ]
  }'

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.