---
title: "Create attachment for appointment"
method: POST
path: "/v1/appointments/{appointment_id}/attachments"
tags: ["appointments"]
---

# Create attachment for appointment

`POST /v1/appointments/{appointment_id}/attachments`

## Request

- Base URL: `https://api-developer-sandbox.zocdoc.com`
- URL: `https://api-developer-sandbox.zocdoc.com/v1/appointments/{appointment_id}/attachments`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://auth.zocdoc.com/oauth/token` scopes: `external.appointment.write`
  - OAuth 2
    - Authorization code: `https://auth.zocdoc.com/authorize`
    - Token URL: `https://auth.zocdoc.com/oauth/token` scopes: `external.appointment.write`

This endpoint is used to upload attachment documents related to the appointment for the provider to view. You can upload more than one attachment with the same attachment_type for the same appointment_id if needed. The provider will be able to receive all uploaded attachments. 

Only documents of type jpg, png, pdf, and docx are supported. Documents must be less than 100MB. You may not upload attachments to appointments in a failed state or over 7 days after the appointment.

## Path parameters

- `appointment_id` string, required

## Request body `multipart/form-data`

- UploadAppointmentAttachmentRequest
  - `attachment` string, binary, required
  - `attachment_type` 'community_care_packet' | 'pcp_patient_referral' | 'patient_front_insurance_card' | 'patient_back_insurance_card', required: The type of attachment being uploaded. - `community_care_packet`: Required for VA referrals to Community Care Providers. Use when submitting referral documents required by the Department of Veterans Affairs for appointments within its extended network. - `pcp_patient_referral`: Use to support appointments booked with an approved referral from a primary care doctor.

## Response `200`

Successfully uploaded attachment

- UploadAppointmentAttachmentResponse
  - `request_id` string, required: Unique request identifier for tracing
  - `data` UploadAppointmentAttachmentResponseData, required
    - `appointment_id` string, required
    - `attachments` UploadedAppointmentAttachment[], required
      - `attachment_type` 'community_care_packet' | 'pcp_patient_referral' | 'patient_front_insurance_card' | 'patient_back_insurance_card', required: The type of attachment being uploaded. - `community_care_packet`: Required for VA referrals to Community Care Providers. Use when submitting referral documents required by the Department of Veterans Affairs for appointments within its extended network. - `pcp_patient_referral`: Use to support appointments booked with an approved referral from a primary care doctor.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/zocdoc/apis/zocdoc-bundle-api.md) - [All operations](https://skmtc.dev/zocdoc/apis/zocdoc-bundle-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zocdoc/apis/zocdoc-bundle-api/revisions/965a6ca4ed12?raw)