Facilities

A facility is a box of working configuration.

If something should be different between sites, it usually belongs to the facility.

What a facility controls

Area	What it means
Doctors	The doctor profiles that can use Tiep in this facility.
Specialties	The facility's editable list used to connect doctors with catalogued forms.
Forms	The forms available for consultations.
Concept sets	Reusable coded lists used by forms.
API keys	Keys used by external systems to call facility endpoints.
Integration settings	Webhook URL, webhook secret, and payload type.
Sessions	The consultation sessions created by doctors or integrations.

Facility specialties

Specialties belong to a facility. They are not a fixed global list.

When creating a facility in the platform, choose the starter specialties the facility needs. The default list is translated into the current platform language, and all entries can later be renamed, added, archived, or removed from the doctor and form editors.

Each catalogued form has one specialty. A doctor can use a catalogued form when the doctor has that specialty.

An optional SNOMED code can be added to a specialty for coded integrations such as HL7/FHIR. Specialties without a code use the General medicine fallback in the legacy HL7/FHIR payload.

When to create more than one facility

Create separate facilities when:

• Different sites need different API keys.
• Different departments need different forms.
• Different clinics send payloads to different webhook URLs.
• Different teams need restricted access.
• Quotas or usage should be tracked separately.

Facility API keys

A facility API key is used by external systems for facility-scoped work.

Use it to:

• Create or update doctor profiles in that facility.
• Generate a short-lived login token for a doctor.
• Send audio or transcripts for extraction.
• Manage public facility forms and concept sets.
• Poll session or background task status.

Example header:

X-API-Key: tiep_facility_key_value

Facility integration settings

Integration settings tell Tiep what to do when a report is saved.

The settings are:

Setting	Meaning
hook	The HTTPS URL Tiep calls when a report is saved.
hook_secret	The secret used to sign the webhook payload.
payload_type	The payload shape, like SIMPLE or HL7_V2.

Read integration settings for the full flow.