---
title: "Update Membership"
method: PATCH
path: "/provider/memberships/{id}"
tags: ["Membership"]
---

# Update Membership

`PATCH /provider/memberships/{id}`

## Path parameters

- `id` string, required

## Request body

- MembershipUpdateSanitizer
  - `membership_patients` MembershipUpdateSanitizerMembershipPatient[], required — Members can be used as an alias for membership_patients
    - `patient` MembershipUpdateSanitizerPatient, required
      - `id` string, required
      - `uses_tobacco` boolean
    - `start_date` string, date — Defaults to Membership start date if not given. Sponsored memberships must start on the 1st of the month. Retail memberships may start any day. Date must be formatted as YYYY-MM-DD.
    - `member_type` 'child' | 'spouse' | 'employee', required — Choose one below. "employee" should only be used on sponsored memberships. Only one employee may be designated per sponsored membership. For non-sponsored memberships, all adults may be sent as "spouse" (naming convention may be updated in the future). All child dependents on all memberships may be sent as "child"
    - `fixed_period_rate_in_cents` integer — Use this to override the standard rates that the membership plan would generate
  - `plan` Association, required
    - `id` string, required
  - `owner` Association
    - `id` string, required
  - `start_date` string, date, required — Sponsored memberships must start on the 1st of the month. Retail memberships may start any day. Date must be formatted as YYYY-MM-DD.
  - `end_date` string, date — Date must be formatted as YYYY-MM-DD.
  - `period_in_months` integer, required — Billing period in months. 1 = monthly, 3 = quarterly, 6 = semi-annually, 12 = annually
  - `fixed_period_rate_in_cents` integer
  - `fixed_registration_fee_in_cents` integer

## Response `200`

Successful response

- PublicMembershipBlueprintOne
  - `id` string
  - `bill_date` string, date
  - `billed_through_date` string, date
  - `billing_start_date` string, date
  - `bills_at_end_of_period` boolean
  - `contract_expiration_action` string
  - `contract_expires` string, date
  - `contract_period_in_months` integer
  - `created_at` string, date-time
  - `end_date` string, date
  - `enrollment_status` string
  - `fixed_period_rate_in_cents` integer
  - `fixed_registration_fee_in_cents` integer
  - `group_code` string
  - `is_confirmed` string
  - `is_current` boolean
  - `is_processing` boolean
  - `is_restartable` boolean
  - `list_price_in_cents` integer
  - `next_bill_date` string, date
  - `period_in_months` string
  - `period_rate_in_cents` integer
  - `rate_in_cents` integer
  - `source_status` string
  - `start_date` string, date
  - `status` string
  - `updated_at` string, date-time
  - `coupon` PublicCouponBlueprintOne
    - `id` string
    - `code` string
    - `description` string
    - `amount_off_in_cents` integer
    - `apply_to_each_patient` boolean
    - `created_at` string, date-time
    - `duration_in_months` integer
    - `percent_off` number, float
    - `updated_at` string, date-time
    - `is_redeemable` boolean
    - `is_archived` boolean
    - `redeemable_from` string, date-time
    - `redeemable_until` string, date-time
  - `membership_patients` PublicMembershipPatientBlueprintForMembershipOne
    - `id` string
    - `member_type` string
    - `fixed_period_rate_in_cents` integer
    - `list_price_in_cents` integer
    - `period_rate_in_cents` integer
    - `revenue_in_cents` integer
    - `start_date` string, date
    - `uses_tobacco` boolean
    - `end_date` string
    - `patient` PublicPatientBlueprintLeaf
      - `id` string
      - `address_city` string
      - `address_country` string
      - `address_line1` string
      - `address_line2` string
      - `address_state` string
      - `address_zip` string
      - `age` string
      - `chosen_first_name` string
      - `chosen_last_name` string
      - `chosen_middle_name` string
      - `chosen_suffix` string
      - `chosen_title` string
      - `created_at` string, date-time
      - `dob` string, date
      - `electronic_communication_consent_accepted` string
      - `electronic_communication_consent_accepted_at` string
      - `email` string
      - `engaged` boolean
      - `external_link_id` string
      - `first_name` string
      - `gender` string
      - `gender_identity` string
      - `gender_other` string
      - `health_insurance_group_id` string
      - `health_insurance_member_id` string
      - `health_insurance_payer_id` string
      - `health_insurance_payer_name` string
      - `hipaa_authorization_accepted` boolean
      - `hipaa_authorization_accepted_at` string, date-time
      - `import_id` string
      - `import_source` string
      - `joined_practice_date` string, date
      - `last_engagement_date` string, date
      - `last_name` string
      - `lead_source_other` string
      - `master_record_sponsor` string
      - `membership_status` string
      - `middle_name` string
      - `name` string
      - `patient_agreement_accepted` boolean
      - `patient_agreement_accepted_at` string, date-time
      - `preferred_language` string
      - `pronouns` string
      - `provider_web_link` string
      - `sex` string
      - `suffix` string
      - `terms_accepted` boolean
      - `terms_accepted_at` string, date-time
      - `updated_at` string, date-time
      - `uses_tobacco` boolean
      - `lead_source` PublicLeadSourceBlueprintOne
        - `id` string
        - `name` string
        - `created_at` string, date-time
        - `updated_at` string, date-time
      - `phones` PublicPhoneBlueprintLeaf
        - `number` string
        - `type` string
      - `sponsorships` PublicCompanySponsorshipBlueprintForPatient
        - `id` string
        - `external_id` string
        - `is_subscriber` boolean
        - `type` string
        - `company` PublicCompanyBlueprintLeaf
          - `id` string
          - `name` string
        - `family` PublicCompanyAccountBlueprintMin
          - `id` string
    - `practitioner` PublicPractitionerBlueprintMin
      - `id` string
      - `name` string
  - `owner` PublicPatientBlueprintLeaf
    - `id` string
    - `address_city` string
    - `address_country` string
    - `address_line1` string
    - `address_line2` string
    - `address_state` string
    - `address_zip` string
    - `age` string
    - `chosen_first_name` string
    - `chosen_last_name` string
    - `chosen_middle_name` string
    - `chosen_suffix` string
    - `chosen_title` string
    - `created_at` string, date-time
    - `dob` string, date
    - `electronic_communication_consent_accepted` string
    - `electronic_communication_consent_accepted_at` string
    - `email` string
    - `engaged` boolean
    - `external_link_id` string
    - `first_name` string
    - `gender` string
    - `gender_identity` string
    - `gender_other` string
    - `health_insurance_group_id` string
    - `health_insurance_member_id` string
    - `health_insurance_payer_id` string
    - `health_insurance_payer_name` string
    - `hipaa_authorization_accepted` boolean
    - `hipaa_authorization_accepted_at` string, date-time
    - `import_id` string
    - `import_source` string
    - `joined_practice_date` string, date
    - `last_engagement_date` string, date
    - `last_name` string
    - `lead_source_other` string
    - `master_record_sponsor` string
    - `membership_status` string
    - `middle_name` string
    - `name` string
    - `patient_agreement_accepted` boolean
    - `patient_agreement_accepted_at` string, date-time
    - `preferred_language` string
    - `pronouns` string
    - `provider_web_link` string
    - `sex` string
    - `suffix` string
    - `terms_accepted` boolean
    - `terms_accepted_at` string, date-time
    - `updated_at` string, date-time
    - `uses_tobacco` boolean
    - `lead_source` PublicLeadSourceBlueprintOne
      - `id` string
      - `name` string
      - `created_at` string, date-time
      - `updated_at` string, date-time
    - `phones` PublicPhoneBlueprintLeaf
      - `number` string
      - `type` string
    - `sponsorships` PublicCompanySponsorshipBlueprintForPatient
      - `id` string
      - `external_id` string
      - `is_subscriber` boolean
      - `type` string
      - `company` PublicCompanyBlueprintLeaf
        - `id` string
        - `name` string
      - `family` PublicCompanyAccountBlueprintMin
        - `id` string
  - `plan` PublicPlanBlueprintMin
    - `id` string
    - `name` string
    - `plan_type` string
  - `sponsorship` PublicCompanyAccountBlueprintForMembershipOne
    - `id` string
    - `company` PublicCompanyBlueprintLeaf
      - `id` string
      - `name` string
  - `upcoming_bills` PublicMembershipBillBlueprintSharedWithInvoice
    - `amount_in_cents` integer
    - `charges_amount_in_cents` integer
    - `coupon_discount_in_cents` integer
    - `coupon_discount_months` integer
    - `coupon_percent_off` integer
    - `date` string, date
    - `end_date` string, date
    - `list_price_in_cents` integer
    - `membership_amount_in_cents` integer
    - `period_in_months` integer
    - `rate_in_cents` integer
    - `registration_fee_in_cents` integer
    - `start_date` string, date
    - `customer_invoice` PublicPayableInvoiceBlueprintForMembershipBill
      - `id` string
      - `human_status` string
      - `invoice_number` string
      - `status` string
      - `amount_in_cents` integer
      - `date` string, date
      - `payment_scheduled_on` string
      - `type` string

---

[API](https://skmtc.net/hint/apis/partner-endpoints.md) · [All operations](https://skmtc.net/hint/apis/partner-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hint/partner-endpoints/revisions/a92ae2a6fa90/schema)