---
title: "Create Customer Invoice"
method: POST
path: "/provider/customer_invoices"
tags: ["CustomerInvoice"]
---

# Create Customer Invoice

`POST /provider/customer_invoices`

## Request body

- ProviderCustomerInvoicesControllerCreateBody — Owner or patient or both must be provided. If you do not specify owner, we will either use the patient's last payer, or the patient themselves
  - `integration_record_id` string
  - `owner` Association
    - `id` string, required
  - `patient` Association
    - `id` string, required
  - `location` Association
    - `id` string, required

## Response `200`

Successful response

- PublicCustomerInvoiceBlueprintOne
  - `id` string
  - `amount_in_cents` integer
  - `charges_count` integer
  - `created_at` string, date-time
  - `date` string, date
  - `due_in_cents` integer
  - `human_status` string
  - `integration_record_id` string
  - `invoice_number` integer
  - `last_sent_at` string, date-time
  - `last_viewed_at` string, date-time
  - `paid_at` string, date-time
  - `paid_in_cents` integer
  - `payment_status` string
  - `payments_count` integer
  - `provider_web_link` string
  - `received_in_cents` integer
  - `status` string
  - `subtotal_in_cents` integer
  - `tax_in_cents` integer
  - `total_in_cents` integer
  - `updated_at` string, date-time
  - `charges` PublicChargeBlueprintOne
    - `id` string
    - `amount_in_cents` integer
    - `created_at` string, date-time
    - `description` string
    - `is_persisted` boolean
    - `name` string
    - `price_in_cents` integer
    - `quantity` integer
    - `service_date` string, date
    - `status` string
    - `subtotal_in_cents` integer
    - `tax_in_cents` integer
    - `total_in_cents` integer
    - `updated_at` string, date-time
    - `category` PublicCategoryBlueprintOne
      - `id` string
      - `name` string
      - `created_at` string, date-time
      - `default_for_memberships` boolean
    - `charge_item` PublicChargeItemBlueprintOne
      - `id` string
      - `code` string
      - `description` string
      - `name` string
      - `provider_web_link` string
      - `created_at` string, date-time
      - `price_in_cents` number, float
      - `quantity_in_stock` integer
      - `updated_at` string, date-time
      - `category` PublicCategoryBlueprintOne
        - `id` string
        - `name` string
        - `created_at` string, date-time
        - `default_for_memberships` boolean
    - `location` PublicLocationBlueprintShared
      - `id` string
      - `address_city` string
      - `address_country` string
      - `address_line1` string
      - `address_line2` string
      - `address_state` string
      - `address_zip` string
      - `name` string
    - `patient` PublicPatientBlueprintOne
      - `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
      - `account` PublicPatientBlueprintAccount
        - `name` string
        - `past_due_in_cents` integer
      - `company` PublicCompanyBlueprintLeaf
        - `id` string
        - `name` string
      - `emergency_contact` CommonEmergencyContactBlueprintShared
        - `id` string
        - `first_name` string
        - `last_name` string
        - `email` string
        - `name` string
        - `relationship` string
        - `relationship_other` string
        - `phone` CommonPhoneBlueprintShared
          - `number` string
          - `type` string
          - `us_formattable` string
      - `external_records` PublicExternalRecordBlueprintMin
        - `source` string
        - `external_id` string
      - `known_practice` PublicKnownPracticeBlueprintMin
        - `id` string
        - `name` string
      - `lead_source` PublicLeadSourceBlueprintOne
        - `id` string
        - `name` string
        - `created_at` string, date-time
        - `updated_at` string, date-time
      - `location` PublicLocationBlueprintOne
        - `id` string
        - `address_city` string
        - `address_country` string
        - `address_latitude` number, float
        - `address_line1` string
        - `address_line2` string
        - `address_longitude` number, float
        - `address_state` string
        - `address_zip` string
        - `distance` string
        - `name` string
        - `phone_number` string
        - `virtual` boolean
        - `location_group` PublicLocationGroupBlueprintLeaf
          - `id` string
          - `created_at` string, date-time
          - `integration_record_id` string
          - `name` string
          - `updated_at` string, date-time
      - `location_group` PublicLocationGroupBlueprintLeaf
        - `id` string
        - `created_at` string, date-time
        - `integration_record_id` string
        - `name` string
        - `updated_at` string, date-time
      - `membership_members` PublicMembershipMemberBlueprintForPatient
        - `id` string
        - `enrollment_status` string
        - `member_type` string
        - `status` string
        - `enrollment_requested_on` string, date
        - `start_date` string, date
        - `end_date` string
        - `membership` PublicMembershipBlueprintMin
          - `id` string
      - `memberships` PublicMembershipPatientBlueprintOne
        - `end_date` string
        - `enrollment_requested_on` string, date
        - `enrollment_status` string
        - `member_type` string
        - `start_date` string, date
        - `status` string
        - `uses_tobacco` boolean
        - `company` PublicCompanyBlueprintLeaf
          - `id` string
          - `name` string
        - `division` PublicEmployeeDivisionBlueprintLeaf
          - `id` string
          - `name` string
        - `payer` PublicPatientBlueprintMin
          - `id` string
          - `name` string
        - `plan` PublicPlanBlueprintMin
          - `id` string
          - `name` string
          - `plan_type` string
      - `merged_into` PublicPatientBlueprintMin
        - `id` string
        - `name` string
      - `phones` PublicPhoneBlueprintLeaf
        - `number` string
        - `type` string
      - `practitioner` PublicPractitionerBlueprintOne
        - `id` string
        - `accepts_enrollments_from_employer` string
        - `accepts_enrollments_from_retail` string
        - `bio` string
        - `created_at` string, date-time
        - `education` string
        - `email` string
        - `gender` string
        - `gender_other` string
        - `integration_record_id` string
        - `max_patient_age` string
        - `min_patient_age` string
        - `name` string
        - `online_signup_visibility` string
        - `panel_size` integer
        - `panel_size_limit` integer
        - `photo_url` string
        - `updated_at` string, date-time
        - `locations` PublicLocationBlueprintOne[]
          - `id` string
          - `address_city` string
          - `address_country` string
          - `address_latitude` number, float
          - `address_line1` string
          - `address_line2` string
          - `address_longitude` number, float
          - `address_state` string
          - `address_zip` string
          - `distance` string
          - `name` string
          - `phone_number` string
          - `virtual` boolean
          - `location_group` PublicLocationGroupBlueprintLeaf
            - `id` string
            - `created_at` string, date-time
            - `integration_record_id` string
            - `name` string
            - `updated_at` string, date-time
        - `npi` PublicNpiBlueprintShared
          - `first_name` string
          - `last_name` string
          - `number` string
          - `organization_name` string
          - `type` string
        - `specialties` PublicSpecialtyBlueprintAll[]
          - object[]
            - `id` string
            - `name` string
      - `practitioner_group` PublicLocationGroupBlueprintLeaf
        - `id` string
        - `created_at` string, date-time
        - `integration_record_id` string
        - `name` string
        - `updated_at` string, date-time
      - `sponsorships` PublicCompanySponsorshipBlueprintForPatient
        - `id` string
        - `external_id` string
        - `is_subscriber` boolean
        - `type` string
        - `company` PublicCompanyBlueprintLeaf
          - `id` string
          - `name` string
        - `family` PublicCompanyAccountBlueprintMin
          - `id` string
      - `ssn` CommonSocialSecurityNumberBlueprintMasked
        - `masked_number` string
    - `practitioner` PublicPractitionerBlueprintOne
      - `id` string
      - `accepts_enrollments_from_employer` string
      - `accepts_enrollments_from_retail` string
      - `bio` string
      - `created_at` string, date-time
      - `education` string
      - `email` string
      - `gender` string
      - `gender_other` string
      - `integration_record_id` string
      - `max_patient_age` string
      - `min_patient_age` string
      - `name` string
      - `online_signup_visibility` string
      - `panel_size` integer
      - `panel_size_limit` integer
      - `photo_url` string
      - `updated_at` string, date-time
      - `locations` PublicLocationBlueprintOne[]
        - `id` string
        - `address_city` string
        - `address_country` string
        - `address_latitude` number, float
        - `address_line1` string
        - `address_line2` string
        - `address_longitude` number, float
        - `address_state` string
        - `address_zip` string
        - `distance` string
        - `name` string
        - `phone_number` string
        - `virtual` boolean
        - `location_group` PublicLocationGroupBlueprintLeaf
          - `id` string
          - `created_at` string, date-time
          - `integration_record_id` string
          - `name` string
          - `updated_at` string, date-time
      - `npi` PublicNpiBlueprintShared
        - `first_name` string
        - `last_name` string
        - `number` string
        - `organization_name` string
        - `type` string
      - `specialties` PublicSpecialtyBlueprintAll[]
        - object[]
          - `id` string
          - `name` string
  - `location` PublicLocationBlueprintShared
    - `id` string
    - `address_city` string
    - `address_country` string
    - `address_line1` string
    - `address_line2` string
    - `address_state` string
    - `address_zip` string
    - `name` string
  - `owner` PublicPatientBlueprintOne
    - `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
    - `account` PublicPatientBlueprintAccount
      - `name` string
      - `past_due_in_cents` integer
    - `company` PublicCompanyBlueprintLeaf
      - `id` string
      - `name` string
    - `emergency_contact` CommonEmergencyContactBlueprintShared
      - `id` string
      - `first_name` string
      - `last_name` string
      - `email` string
      - `name` string
      - `relationship` string
      - `relationship_other` string
      - `phone` CommonPhoneBlueprintShared
        - `number` string
        - `type` string
        - `us_formattable` string
    - `external_records` PublicExternalRecordBlueprintMin
      - `source` string
      - `external_id` string
    - `known_practice` PublicKnownPracticeBlueprintMin
      - `id` string
      - `name` string
    - `lead_source` PublicLeadSourceBlueprintOne
      - `id` string
      - `name` string
      - `created_at` string, date-time
      - `updated_at` string, date-time
    - `location` PublicLocationBlueprintOne
      - `id` string
      - `address_city` string
      - `address_country` string
      - `address_latitude` number, float
      - `address_line1` string
      - `address_line2` string
      - `address_longitude` number, float
      - `address_state` string
      - `address_zip` string
      - `distance` string
      - `name` string
      - `phone_number` string
      - `virtual` boolean
      - `location_group` PublicLocationGroupBlueprintLeaf
        - `id` string
        - `created_at` string, date-time
        - `integration_record_id` string
        - `name` string
        - `updated_at` string, date-time
    - `location_group` PublicLocationGroupBlueprintLeaf
      - `id` string
      - `created_at` string, date-time
      - `integration_record_id` string
      - `name` string
      - `updated_at` string, date-time
    - `membership_members` PublicMembershipMemberBlueprintForPatient
      - `id` string
      - `enrollment_status` string
      - `member_type` string
      - `status` string
      - `enrollment_requested_on` string, date
      - `start_date` string, date
      - `end_date` string
      - `membership` PublicMembershipBlueprintMin
        - `id` string
    - `memberships` PublicMembershipPatientBlueprintOne
      - `end_date` string
      - `enrollment_requested_on` string, date
      - `enrollment_status` string
      - `member_type` string
      - `start_date` string, date
      - `status` string
      - `uses_tobacco` boolean
      - `company` PublicCompanyBlueprintLeaf
        - `id` string
        - `name` string
      - `division` PublicEmployeeDivisionBlueprintLeaf
        - `id` string
        - `name` string
      - `payer` PublicPatientBlueprintMin
        - `id` string
        - `name` string
      - `plan` PublicPlanBlueprintMin
        - `id` string
        - `name` string
        - `plan_type` string
    - `merged_into` PublicPatientBlueprintMin
      - `id` string
      - `name` string
    - `phones` PublicPhoneBlueprintLeaf
      - `number` string
      - `type` string
    - `practitioner` PublicPractitionerBlueprintOne
      - `id` string
      - `accepts_enrollments_from_employer` string
      - `accepts_enrollments_from_retail` string
      - `bio` string
      - `created_at` string, date-time
      - `education` string
      - `email` string
      - `gender` string
      - `gender_other` string
      - `integration_record_id` string
      - `max_patient_age` string
      - `min_patient_age` string
      - `name` string
      - `online_signup_visibility` string
      - `panel_size` integer
      - `panel_size_limit` integer
      - `photo_url` string
      - `updated_at` string, date-time
      - `locations` PublicLocationBlueprintOne[]
        - `id` string
        - `address_city` string
        - `address_country` string
        - `address_latitude` number, float
        - `address_line1` string
        - `address_line2` string
        - `address_longitude` number, float
        - `address_state` string
        - `address_zip` string
        - `distance` string
        - `name` string
        - `phone_number` string
        - `virtual` boolean
        - `location_group` PublicLocationGroupBlueprintLeaf
          - `id` string
          - `created_at` string, date-time
          - `integration_record_id` string
          - `name` string
          - `updated_at` string, date-time
      - `npi` PublicNpiBlueprintShared
        - `first_name` string
        - `last_name` string
        - `number` string
        - `organization_name` string
        - `type` string
      - `specialties` PublicSpecialtyBlueprintAll[]
        - object[]
          - `id` string
          - `name` string
    - `practitioner_group` PublicLocationGroupBlueprintLeaf
      - `id` string
      - `created_at` string, date-time
      - `integration_record_id` string
      - `name` string
      - `updated_at` string, date-time
    - `sponsorships` PublicCompanySponsorshipBlueprintForPatient
      - `id` string
      - `external_id` string
      - `is_subscriber` boolean
      - `type` string
      - `company` PublicCompanyBlueprintLeaf
        - `id` string
        - `name` string
      - `family` PublicCompanyAccountBlueprintMin
        - `id` string
    - `ssn` CommonSocialSecurityNumberBlueprintMasked
      - `masked_number` 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/versions/a92ae2a6fa90/schema)