---
title: "Called by clinician signup form"
method: POST
path: "/webhooks/clinician-signup-form"
tags: ["webhook"]
---

# Called by clinician signup form

`POST /webhooks/clinician-signup-form`

Creates a clinic and clinicians. Default clinic feature flags are merged into
clinic.flags_raw for every request, based on clinic.clinic_type (wellness vs
diabetes/obesity presets); explicit flags in the request body override defaults.
When create_hospital query parameter is true, also creates a new hospital using
the clinic name. In that case, hospital_id in the request body becomes optional.

## Query parameters

- `create_hospital` boolean

## Request body

- CreateClinicAndCliniciansRequest — The server merges default feature flags into clinic.flags_raw according to clinic.clinic_type (e.g. wellness vs diabetes/obesity). Values sent in clinic.flags_raw override those defaults. Other clinic types receive no preset flags unless provided in the request. When create_hospital query parameter is true, hospital_id is optional and a new hospital will be created using the clinic name. Otherwise, hospital_id is required. The country field is optional and defaults to Canada when creating a hospital. Valid country values are Canada or USA.
  - `clinic` CreateClinicRequest, required
    - `address` string, nullable — Street address (line 1) where the clinic is located
    - `city` string, nullable
    - `clinic_address` string, nullable
    - `clinic_email` string, nullable
    - `clinic_invitation_code` string, nullable
    - `clinic_logo_base64` string, nullable — Base64-encoded logo image; optional data: URL prefix. Stored in public bucket when provided.
    - `clinic_logo_filename` string, nullable — Original filename for extension hint (e.g. logo.png)
    - `clinic_logo_url` string, nullable — Public HTTPS URL for clinic logo (used as-is when set without clinic_logo_base64)
    - `clinic_phone_number` string, nullable
    - `clinic_postal_code` string, nullable
    - `clinic_state_province` string, nullable
    - `clinic_type` 'corporate' | 'research' | 'collaboration' | 'wellness' | 'obesity' | 'diabetes' | 'metabolic syndrome' | 'weight loss' | 'migraine' | 'gastroesophageal reflux' | 'gi discomfort' | 'vertigo' | 'sleep apnea' | 'rxlife' | 'dexcom' | 'menopause', required
    - `clinic_website` string, nullable
    - `config_add_default_goals_to_new_patients` boolean, nullable
    - `config_add_default_tips_to_new_patients` boolean, nullable
    - `country` string, nullable — Clinic mailing country. Valid values are 'Canada' or 'USA'. Aliases 'US' and 'United States' are accepted and normalized to 'USA'.
    - `default_report_template` string[], nullable
    - `description` string, nullable
    - `flags_raw` RxFeatureFlagsResponse
      - `auditor_reviewer_is_external` boolean
      - `clinic_admin_api_access` boolean
      - `clinic_allow_cross_hospital_report_access` boolean
      - `clinic_auto_log_photos_enabled` boolean
      - `clinic_default_days_until_report_date` string
      - `clinic_default_mark_patients_as_priority` boolean
      - `clinic_default_patient_age` string
      - `clinic_default_patient_sex` string
      - `clinic_default_report_include_supplements_in_food_dump` boolean
      - `clinic_default_report_include_supplements_in_rdi` boolean
      - `clinic_default_sms_enabled` boolean
      - `clinic_default_subscription_name` string
      - `clinic_default_user_locale` string
      - `clinic_enable_clinician_advisor_chat` boolean
      - `clinic_invitation_email_cadence` string
      - `clinic_maximum_meal_capture_period_in_days_before_subscription` string
      - `clinic_report_autogenerate` boolean
      - `clinic_report_full_automation` boolean
      - `clinic_report_identity_mode` 'normal' | 'anonymous' | 'identifier_patient_id' | 'identifier_external_id' | 'identifier_both_ids'
      - `clinic_report_judge_confidence_min` string, nullable
      - `clinic_send_repeat_subscription_invitation_email` boolean
      - `clinic_send_subscription_invitation_email` boolean
      - `clinic_show_patient_report_secure_link` boolean
      - `clinic_subscription_reminder_email_cadence` string
      - `clinic_subscription_types` string
      - `clinician_allow_meal_edit` boolean
      - `clinician_autopilot_enabled` boolean
      - `clinician_available_trial_lengths` string
      - `clinician_can_delete_meals` boolean
      - `clinician_can_generate_reports` boolean
      - `clinician_can_view_clinic_invite_code` boolean
      - `clinician_meal_planner_enabled` boolean
      - `clinician_oversight_of_patient` 'clinician' | 'non-clinician'
      - `clinician_patient_allow_cal_carb_toggle` boolean
      - `clinician_patient_allow_macro_card_toggle` boolean
      - `clinician_patient_allow_mindful_eating_survey_toggle` boolean
      - `clinician_patient_allow_patient_app_coaching_tab_toggle` boolean
      - `clinician_prevent_new_patients_after_date` string, nullable
      - `clinician_report_24h_turnaround` boolean
      - `clinician_report_disable_early_generation` boolean
      - `clinician_require_mfa` boolean
      - `clinician_show_timeline` boolean
      - `email_template_id_clinic_logging_completion` string
      - `email_template_id_clinic_logging_starts_tomorrow` string
      - `email_template_id_clinic_onboarding` string
      - `email_template_id_clinic_registered_but_no_meals` string
      - `email_template_id_clinic_reminder_to_continue_logging` string
      - `email_template_id_clinic_report_available` string
      - `email_template_id_clinic_thirty_day_subscription_inactive_logging_reminder` string
      - `email_template_id_clinic_upcoming_subscription` string
      - `email_template_id_returning_invitation` string
      - `hospital_patient_custom_fields_json` string
      - `hospital_patient_has_external_id` boolean
      - `lifecycle_messaging_variant_patient_invited` string
      - `lifecycle_messaging_variant_patient_logging_completed` string
      - `lifecycle_messaging_variant_patient_report_available` string
      - `lifecycle_messaging_variant_patient_subscription_notification` string
      - `lifecycle_messaging_variant_patient_subscription_reminder` string
      - `patient_app_care_team_experience` boolean
      - `patient_app_coaching_tab` boolean
      - `patient_app_extended_logging_types` string, nullable
      - `patient_app_guided_health_program` boolean
      - `patient_app_hide_meal_after_n_hours` string, nullable
      - `patient_app_hide_nutrition_starplot` boolean, nullable
      - `patient_app_key_nutrients` string, nullable
      - `patient_app_mindful_eating_survey` boolean
      - `patient_app_nutritional_insights` boolean
      - `patient_app_nutritional_insights_sections_to_hide` string, nullable
      - `patient_app_partner_branding` string, nullable
      - `patient_app_partner_movano` boolean
      - `patient_app_partner_oauth_provider` string, nullable
      - `patient_app_pii_minimal_masking` boolean, nullable
      - `patient_app_primary_macronutrient` string, nullable
      - `patient_app_primary_macronutrient_can_edit` boolean
      - `patient_app_show_dev_settings` boolean
      - `patient_app_show_diet_score` boolean
      - `patient_app_show_macro_nutrition_card` boolean
      - `patient_app_show_nutrition_data_and_insights` boolean
      - `patient_app_show_schedule_call_with_doctor` boolean
      - `patient_app_use_care_team_version` boolean
      - `patient_app_use_timeline` boolean
      - `patient_app_use_v3_ui` boolean
      - `patient_app_v2_care_team_ui` boolean
      - `patient_can_view_pdf_reports` boolean
      - `patient_default_measure_system` string
      - `patient_enforce_subscription` boolean
      - `patient_glucose_units_mmol_l` boolean
      - `patient_goals_can_edit` boolean
      - `patient_preferred_nutrition_source` string
      - `patient_report_quality_judge` boolean
      - `patient_send_meal_reminders` boolean — this is still configurable by the patient, unless it is False - then all the alerts are blocked.
      - `patient_show_cals` boolean
      - `patient_show_carbs` boolean
      - `patient_show_dexcom_oauth` boolean
      - `patient_show_gender` boolean
      - `patient_show_total_carbs` boolean
      - `patient_use_exercise` boolean
      - `patient_use_medication` boolean
      - `patient_use_question` boolean
      - `patient_use_sleep` boolean
      - `user_require_password_strength` boolean
    - `full_name` string, nullable — Full/legal clinic name
    - `name` string, required
    - `receive_report_notification` boolean, nullable
    - `receive_report_pdf_by_email` boolean, nullable
    - `report_template_sections` object, nullable
    - `state` string, nullable — Region / state / province for structured address
    - `zip_code` string, nullable
  - `clinicians` CreateClinicianRequest[], required
    - `bio` string, required
    - `clinic_ids` integer[], nullable — array of clinic ids to add the clinician to. clinician must be in the hospital of each.
    - `email` string, required
    - `first_name` string, required
    - `is_clinic_admin` boolean, nullable
    - `is_notified_of_report` boolean, nullable
    - `last_name` string, required
    - `password` string, nullable
    - `phone_number` string
    - `preferred_contact` boolean, nullable
  - `country` string, nullable — Country for the hospital when create_hospital=true. Valid values are 'Canada' or 'USA'. Aliases 'US' and 'United States' are accepted and normalized to 'USA'. Defaults to 'Canada' if not provided.
  - `hospital_id` integer, nullable
  - `signup_metadata_non_sensitive` object, nullable — Additional signup metadata that does not contain sensitive information. Safe to send to, ex, Metabase and product analytics providers. Currently included in a PatientSignupMetadata telemetry_event.
  - `signup_metadata_sensitive` object, nullable — Additional signup metadata that contains sensitive information (PII, PHI, etc). Will not be sent to, ex, Metabase and product analytics providers. Currently included in a PatientSignupMetadata telemetry_event.

## Response `200`

successful operation

---

[API](https://skmtc.dev/rxfoodapp/apis/inneranalytics-mnt-server.md) · [All operations](https://skmtc.dev/rxfoodapp/apis/inneranalytics-mnt-server/llms.txt) · [OpenAPI document](https://skmtc.dev/rxfoodapp/apis/inneranalytics-mnt-server/revisions/04eb7a66328a?raw)
