# Link Invoice to Appointment

Links an external Stripe invoice to an appointment.

This endpoint finds or creates a Hero invoice record from a Stripe invoice ID,
then links it to the specified appointment.

Endpoint: POST /v1/invoicing/invoices/link
Version: 1.0.0
Security: apiKeyAuth, practiceGroupId

## Request fields (application/json):

  - `stripe_invoice_id` (string, required)

  - `appointment_id` (string, required)

  - `issuer_id` (string, required)

## Response 200 fields (application/json):

  - `id` (string,null)

  - `stripe_id` (string, required)

  - `status` (string)

  - `subtotal` (number)

  - `amount_due` (number)

  - `customer_id` (string,null)

  - `patient_record_id` (string,null)

  - `appointment_id` (string,null)

  - `created_at` (string)

  - `updated_at` (string)

## Response 400 fields (application/json):

  - `error` (boolean, required)
    Example: true

  - `statusCode` (number, required)
    Example: 400

  - `message` (array, required)

  - `message.code` (string, required)
    Example: "invalid_type"

  - `message.expected` (string, required)
    Example: "string"

  - `message.path` (array, required)
    Example: ["patient_id"]


## Response 401 fields

## Response 404 fields

## Response 500 fields