---
title: "Add a new subscription to study events"
method: POST
path: "/api/study/{studyId}/subscriptions"
tags: ["Subscriptions"]
---

# Add a new subscription to study events

`POST /api/study/{studyId}/subscriptions`

## Path parameters

- `studyId` string, uuid, required — Study identifier

## Request body

- SubscriptionRequest
  - `name` string, nullable
  - `url` string, nullable
  - `events` SubscriptionEventRequest[], nullable
    - `eventId` string, uuid
    - `edcObject` EdcObjectRequest
      - `id` string, uuid
      - `name` string, nullable
      - `type` string, nullable
      - `subType` integer, nullable
      - `disabled` boolean
  - `emails` string[], nullable

## Response `201`

Success

- SubscriptionResponseEventResultWithResponse
  - `processedSuccessfully` boolean
  - `processMessage` string, nullable
  - `response` SubscriptionResponse
    - `id` string, uuid, nullable
    - `studyId` string, uuid
    - `name` string, nullable
    - `url` string, nullable
    - `events` SubscriptionEventResponse[], nullable
      - `eventId` string, uuid
      - `category` string, nullable
      - `name` string, nullable
      - `edcObject` EdcObjectResponse
        - `id` string, uuid
        - `name` string, nullable
        - `type` string, nullable
        - `subType` integer, nullable
        - `disabled` boolean
    - `emails` string[], nullable

---

[API](https://skmtc.net/medrio/apis/medrio-openapi-v-42-14-0-201.md) · [All operations](https://skmtc.net/medrio/apis/medrio-openapi-v-42-14-0-201/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/medrio/medrio-openapi-v-42-14-0-201/versions/df94f6005a8d/schema)