---
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`

## Request

- Base URL: `https://connectapi.medrio.com` (the document declares no server; this is the origin it was published from)
- URL: `https://connectapi.medrio.com/api/study/{studyId}/subscriptions`
- Auth: API key in header `Authorization`

## 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.dev/medrio/apis/medrio-openapi-v-42-14-0-201.md) - [All operations](https://skmtc.dev/medrio/apis/medrio-openapi-v-42-14-0-201/llms.txt) - [OpenAPI document](https://skmtc.dev/medrio/apis/medrio-openapi-v-42-14-0-201/revisions/17293ddcbc0b?raw)
