# Add Realtime Media Streams features to your app

<!-- WARNING: THIS FILE WAS AUTOGENERATED! DO NOT EDIT! -->

Once Realtime Media Streams (RTMS) has been added to your account, you need to create a new general or server-to-server app and add RTMS to it, or add RTMS to an existing app. For more information on creating an app, see [Quick start guide](/docs/build-flow/quick-start-guide/) in the _Build your app_ guide.

To add RTMS to your app, you'll need to add

-   Event subscriptions for RTMS [started](/docs/api/rtms/events/#tag/contact_center/postcontact_center.voice_rtms_started) and [stopped](/docs/api/rtms/events/#tag/contact_center/postcontact_center.voice_rtms_stopped) events
-   Scopes for the media you want to access

This video walks you through marketplace and account configuration to create and use ZCC RTMS apps.

[![Create and use RTMS ZCC apps in ZCC workflow](https://img.youtube.com/vi/NYWb3CuEljY/maxresdefault.jpg)](https://www.youtube.com/watch?v=NYWb3CuEljY)

> The demo video walks through set up for a **user-managed** application. If using admin-level scopes, select **"admin-managed"** on your marketplace app homepage.

## Create an app

To use RTMS, you'll need to create a General app on the Zoom App Marketplace that you can then add RTMS features to. For more information on creating an app, see [Quick start guide](/docs/build-flow/quick-start-guide/) in the _Build your app_ guide.

## Subscribe to RTMS started and stopped events

RTMS [uses event subscriptions](/docs/api/rtms/events/) to notify your app when a session starts and stops in Zoom Contact Center (ZCC) engagements. Use these events to [work with RTMS streams](/docs/rtms/contact-center/work-with-streams/).

### To subscribe to RTMS events

1. Sign into the [Zoom App Marketplace](https://marketplace.zoom.us/).
2. To go to the app, in the upper-right of the screen, choose **Manage**.
   ![The app marketplace pointing to the Manage button](/img/app-marketplace.png)
3. Select your app from the list.
4. In the navigation pane, choose **Access**.

    ![The app side nav pointing to Access](/img/app-sidenav.png)

5. In the **General Features** section, turn on **Event Subscription**.
6. Set up the event subscription
    1. Give your subscription a name.
    2. Choose **Add Events**, search for _RTMS_, and select the events you want to subscribe to. We recommend subscribing to all of the available ones, but you'll need _RTMS Started_ and _RTMS Stopped_ for RTMS to work.
    3. Choose **Done**.
7. Enter the **Event notification endpoint URL** where you'll receive events.
8. Choose **Save**.

Now that you've added event subscriptions to your account, you'll need to add RTMS scopes.

## Add RTMS scopes to your app

Your app will also require scopes to receive audio data. Scopes tell the [media servers](/docs/rtms/contact-center/media/) which data to send from ZCC engagements.

> Your app will need [Granular scopes](/docs/integrations/oauth-scopes-granular/) to use RTMS scopes. Granular scopes are the default for new apps, but older apps might need them to be enabled. Update your app if you do not see RTMS scopes in your list of available scopes.

### To add scopes to your app

1. Sign into the [Zoom App Marketplace](https://marketplace.zoom.us/).
2. To go to the app, in the upper-right of the screen, choose **Manage**.
3. Select your app from the list.
4. In the navigation pane, choose **Scopes**.
5. Choose **+ Add Scopes**, search for _RTMS_, and select the scopes you want to add. For example, if you want to get audio data from a ZCC engagement, add the `contact_center:read:zcc_voice_audio` scope.

### (Optional) Add REST APIs for session status

RTMS can also be started and stopped using a REST API call from your app to [Update engagement Real-Time Media Streams (RTMS) app status](/docs/api/contact-center/#tag/rtms/post/contact_center/{engagementId}/rtms_app/status). This allows your app to start an RTMS session for a participant with an access token.

Using this endpoint requires the contact_center:update:engagement_rtms_app_status scope. For more information about adding scopes, see [Add ZCC RTMS scopes to your app](/docs/rtms/contact-center/add-features/#add-rtms-scopes-to-your-app).