---
title: "Complete user profile"
method: POST
path: "/api/auth/complete-profile"
tags: ["auth"]
---

# Complete user profile

`POST /api/auth/complete-profile`

Complete or update user profile information. Requires authentication.

## Request body

- CompleteProfileRequest — Complete user profile request model.
  - `first_name` string, nullable — User first name
  - `last_name` string, nullable — User last name
  - `phone` string, nullable — User phone number
  - `home_address` string, nullable — User home address
  - `city` string, nullable — User city
  - `province` string, nullable — User province
  - `postal_code` string, nullable — User postal code
  - `place_of_birth` string, nullable — User place of birth
  - `tax_code` string, nullable — User tax code (codice fiscale)
  - `gender` string, nullable — User gender
  - `registration_reason` string, nullable — Reason for registration
  - `commercial_communications_consent` boolean, nullable — Consent to receive commercial and promotional communications
  - `how_did_you_hear_about_us` string, nullable — How did you hear about us
  - `date_of_birth` string, nullable — User date of birth (YYYY-MM-DD). Can only be set once.
  - `tax_code_type` string, nullable — Tax code type: 'italian' or 'foreign' (required if tax_code is provided)
  - `country_of_residence` string, nullable — User country of residence
  - `gp_first_name` string, nullable — General practitioner first name
  - `gp_last_name` string, nullable — General practitioner last name
  - `gp_email` string, nullable — General practitioner email
  - `gp_phone` string, nullable — General practitioner phone
  - `third_party_contact_enabled` boolean, nullable — Enable/disable third-party contact for patient updates
  - `third_party_contact_first_name` string, nullable — Third-party contact first name
  - `third_party_contact_last_name` string, nullable — Third-party contact last name
  - `third_party_contact_relationship` string, nullable — Third-party contact role/kinship degree
  - `third_party_contact_phone` string, nullable — Third-party contact mobile phone
  - `third_party_contact_email` string, nullable — Third-party contact email
  - `third_party_contacts` ThirdPartyContactV2[], nullable — Full list of the patient's third-party contacts to upsert (create new / update by id). When provided, takes precedence over the single third_party_contact_* fields.
    - `id` string, nullable — Third-party contact UUID
    - `enabled` boolean — Whether the third-party contact is enabled
    - `first_name` string, required — First name
    - `last_name` string, required — Last name
    - `relationship` string, required — Role or kinship degree
    - `phone` string, nullable — Mobile phone number (optional)
    - `email` string, nullable — Email

## Response `200`

Successful Response

- CompleteProfileResponse — Complete profile response model.
  - `title` string — Response title
  - `message` string — Response message
  - `user` UserProfileResponse, required — User profile response model with complete user information.
    - `id` string, required — User ID
    - `email` string, required — User email
    - `first_name` string, nullable — User first name
    - `last_name` string, nullable — User last name
    - `place_of_birth` string, nullable — User place of birth
    - `phone` string, nullable — User phone number
    - `tax_code` string, nullable — User tax code (codice fiscale)
    - `date_of_birth` string, nullable — User date of birth (YYYY-MM-DD)
    - `country_of_residence` string, nullable — User country of residence
    - `city` string, nullable — User city
    - `province` string, nullable — User province
    - `postal_code` string, nullable — User postal code
    - `home_address` string, nullable — User home address
    - `gender` string, nullable — User gender
    - `how_did_you_hear_about_us` string, nullable — How did you hear about us
    - `registration_reason` string, nullable — Reason for registration (enum key, e.g. WANT_TO_START_JOURNEY)
    - `commercial_communications_consent` boolean — Consent to receive commercial and promotional communications
    - `social_provider` string, nullable — Social provider used for login or null if email/password
    - `has_profile_photo` boolean — Whether user has a profile photo uploaded. Use /api/storage/profile-photo/{user_id} to retrieve it.
    - `roles` string[] — User roles
    - `general_practitioner` GeneralPractitioner — General practitioner data model.
      - `id` string, nullable — General practitioner UUID
      - `first_name` string — First name
      - `last_name` string — Last name
      - `email` string, nullable — Email
      - `phone` string, nullable — Phone number
    - `third_party_contacts` ThirdPartyContactV2[] — Patient's third-party contacts (v2). Set only when the user is a patient; empty list otherwise.
      - `id` string, nullable — Third-party contact UUID
      - `enabled` boolean — Whether the third-party contact is enabled
      - `first_name` string, required — First name
      - `last_name` string, required — Last name
      - `relationship` string, required — Role or kinship degree
      - `phone` string, nullable — Mobile phone number (optional)
      - `email` string, nullable — Email
    - `third_party_contact` ThirdPartyContact — Single third-party contact model (v1 single-contact API).
      - `id` string, nullable — Third-party contact UUID
      - `enabled` boolean — Whether third-party contact is enabled
      - `first_name` string, required — First name
      - `last_name` string, required — Last name
      - `relationship` string, required — Role or kinship degree
      - `phone` string, nullable — Mobile phone number (optional)
      - `email` string, nullable — Email
    - `third_party_consent` boolean — Whether the patient accepted the third-party contacts treatment consent. Gates adding/editing third-party contacts.
    - `tax_deduction_consent` boolean, nullable — Whether the patient accepted the tax data transmission needed for the deduction. Null when never answered: the app asks before the first payment.
    - `first_login` boolean, nullable — Whether this is the user's first login
    - `notes` string, nullable — Internal notes
    - `deletion_requested_at` string, nullable — Deletion request timestamp ISO
    - `created_at` string, nullable — Creation timestamp ISO
    - `updated_at` string, nullable — Last update timestamp ISO
    - `patient_id` string, nullable — Related patient id
    - `operator_id` string, nullable — Related operator id
    - `social_registration` boolean, nullable — Whether user registered via social provider
  - `warnings` string[], nullable — List of warnings (e.g., tax code auto-calculation failed)

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/corabea/apis/corabea-api.md) · [All operations](https://skmtc.dev/corabea/apis/corabea-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/corabea/corabea-api/revisions/13c1bce1bdc4/schema)