---
title: "Create Subscriptions for multiple Patients"
method: POST
path: "/api/v2/patients/subscriptions"
tags: ["Subscriptions"]
---

# Create Subscriptions for multiple Patients

`POST /api/v2/patients/subscriptions`

## Request

- Base URL: `https://sandbox.particlehealth.com`
- URL: `https://sandbox.particlehealth.com/api/v2/patients/subscriptions`
- Auth: API key in header `Authorization`

## Request body

- ApiPatientSubscriptionsRequestPayload
  - `subscriptions` ApiPatientSubscriptionRequestPayload[], required
    - `monitoring_plan` string: Optional. Name of the Monitoring Plan to enroll the patient on, as configured for your organization or provided by Particle for all organizations (for example ACTIVE or PASSIVE); your organization's plans are checked first. Matched case-insensitively. When omitted, the patient is enrolled on your organization's default plan. If no plan with this name exists for your organization or among Particle's shared plans, an individual-patient request is rejected with HTTP 404, while a cohort request returns HTTP 200 with a per-patient error; both use error code MONITORING_PLAN_NOT_FOUND. Only applies to subscription type MONITORING.
    - `particle_patient_id` string: Required when creating subscriptions for multiple patients (POST /patients/subscriptions). Ignored on the per-patient endpoints, which take the patient from the path.
    - `referred_to_oid` string
    - `type` string, required: The subscription type.

## Response `200`

OK

- ApiPatientSubscriptions
  - `subscriptions` ApiPatientSubscription[]
    - `particle_patient_id` string
    - `type` string

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `406`: Not Acceptable
- `500`: Internal Server Error

## Changes

- **2026-11-03** `b59a5413a488`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/particlehealth/apis/particle-health-api/changes/api/v2/patients/subscriptions/post.md)

---

[API](https://skmtc.dev/particlehealth/apis/particle-health-api.md) - [All operations](https://skmtc.dev/particlehealth/apis/particle-health-api/llms.txt) - [OpenAPI document](https://skmtc.dev/particlehealth/apis/particle-health-api/revisions/b59a5413a488?raw)